154 lines
6.8 KiB
Markdown
154 lines
6.8 KiB
Markdown
# HPL Toolbox
|
|
|
|
Bundled VS Code extension and standalone tools for playable ad workflows.
|
|
|
|
# Tools
|
|
|
|
- **PLEC Upload** - Upload selected HTML files to the internal PLEC server.
|
|
- **AppLovin Playable Preview** - Upload HTML files to p.applov.in and generate QR preview links.
|
|
- **Base64 Scanner** - Scan HTML files for external or non-base64 asset references.
|
|
- **Send To Mobile** - Share selected HTML files to a phone over LAN with a QR code.
|
|
- **MRAID Checker** - Check HTML files against MRAID requirements and best practices.
|
|
- **Mintegral Checker** - Validate Mintegral playable ZIPs against PlayTurbo requirements.
|
|
- **Playworks Converter** - Convert Playworks HTML into per-network variants.
|
|
- **Device Simulator** - Preview HTML playables inside accurate mobile device frames with notch and Dynamic Island overlays.
|
|
- **Initialize Project** - Download team template files (AGENTS.md, LOCALIZATION.md, .gitignore) from a shared Google Drive manifest.
|
|
|
|
# Changelog
|
|
|
|
**v0.1.2**
|
|
```
|
|
Added
|
|
- Added local hosting for HTML files.
|
|
- Added the standalone app.
|
|
```
|
|
|
|
**v0.1.3**
|
|
```
|
|
Added
|
|
- Added QR regeneration for AppLovin previews that fail to render.
|
|
- Added Save QR and Save All QRs actions.
|
|
|
|
Changed
|
|
- Updated AppLovin Demo Upload.
|
|
- Improved the file selection workflow.
|
|
```
|
|
|
|
**v0.1.5**
|
|
```
|
|
Added
|
|
- Added multi-file selection for PLEC Upload.
|
|
- Added automatic iteration name detection.
|
|
|
|
Changed
|
|
- Improved PLEC Upload file selection.
|
|
- Moved standalone temporary files into the user temp folder.
|
|
```
|
|
|
|
**v0.1.6**
|
|
```
|
|
Added
|
|
- Added beta tools for further testing:
|
|
- Playworks Converter for converting Playworks UnityAds HTML into other network variants.
|
|
- MRAID Checker for scanning HTML files against MRAID requirements and best practices.
|
|
|
|
Changed
|
|
- Simplified the UI.
|
|
```
|
|
|
|
**v0.1.7**
|
|
```
|
|
Added
|
|
- Added standalone drag-and-drop file/folder selection for HTML inputs across supported tools.
|
|
- Added status throbber/progress updates for batch scans, uploads, sharing, and conversions.
|
|
- Added streamed standalone progress updates so long-running actions update the status bar before completion.
|
|
|
|
Changed
|
|
- MRAID Checker is no longer marked as beta in extension or standalone.
|
|
- Playworks Converter source selection now matches the other file-selection UIs more closely.
|
|
- Playworks Converter default output folder now resolves to the input file location's Output folder.
|
|
- Progress text now follows the format: [throbber] Verb count file.
|
|
|
|
Fixed
|
|
- Fixed standalone drag-and-drop handling for multiple files and multiple folders.
|
|
- Fixed cleanup behavior for temporary dropped files when clearing or removing rows.
|
|
- Fixed standalone PLEC Upload Open button using an incorrect/mangled URL by switching to the Windows URL protocol handler.
|
|
```
|
|
|
|
**v0.2.0**
|
|
```
|
|
Added
|
|
- Added Mintegral Checker to the VS Code extension.
|
|
- Added Mintegral Checker to the standalone app.
|
|
- Added PlayTurbo-compatible runtime validation for Mintegral playables using the injected preview utility script.
|
|
|
|
Changed
|
|
- Mintegral Checker is available as a regular tool, not a beta tool.
|
|
- Standalone navigation now uses a collapsible sidebar with compact tool initials.
|
|
- Mintegral Checker UI now embeds the playable preview, checklist, runtime events, mute, and reload controls in one view.
|
|
```
|
|
|
|
**v0.2.1**
|
|
```
|
|
Added
|
|
- Added Device Simulator to the VS Code extension and standalone app.
|
|
- Added editable Device Simulator device lists with add, delete, restore defaults, import, and export.
|
|
- Added drag-and-drop reordering for Device Simulator devices.
|
|
- Added iPhone 17, iPhone Air, iPhone 17 Pro, and iPhone 17 Pro Max defaults.
|
|
- Added drag-and-drop tool reordering with persisted order in the VS Code launcher and standalone Home/sidebar.
|
|
|
|
Changed
|
|
- Device Simulator settings now use a modal list manager with multi-select, add/delete, and move up/down controls.
|
|
- Standalone Device Simulator sidebar abbreviation is now DS.
|
|
- Send To Mobile browser preview now opens playables in a delayed full-screen preview wrapper while Download still serves the original HTML.
|
|
|
|
Fixed
|
|
- Fixed Device Simulator mute for HTML media and WebAudio playables.
|
|
- Fixed Device Simulator Add Device and Remove Device interactions inside embedded webviews.
|
|
- Fixed Send To Mobile browser preview spending the View button's initial tap as a premature playable click-through while preserving real user-initiated redirects.
|
|
```
|
|
|
|
**v0.2.2**
|
|
```
|
|
Added
|
|
- Added automatic update checking to the VS Code extension and standalone app.
|
|
```
|
|
|
|
**v0.2.3**
|
|
```
|
|
Added
|
|
- Added Localization dropdown in Device Simulator.
|
|
```
|
|
|
|
**v0.2.4**
|
|
```
|
|
Added
|
|
- Added Initialize Project tool to the VS Code extension and standalone app.
|
|
- Downloads team template files (AGENTS.md, LOCALIZATION.md, .gitignore) from a shared manifest.
|
|
- Manifest is a JSON file hosted on Google Drive or any direct URL, listing files with name, URL, and description.
|
|
- Manifest URL is configurable per-user; defaults to the shared team Google Drive manifest.
|
|
- Google Drive share links are automatically converted to direct download URLs.
|
|
- Files panel shows a checklist loaded from the manifest with per-file Open button and Refresh/Configure controls.
|
|
- Destination folder is selectable via folder picker, defaulting to workspace root in the extension.
|
|
- Standalone stores the manifest URL in config.json and exposes an inline URL editor via the settings (⚙) button.
|
|
```
|
|
|
|
**v1.0.0**
|
|
```
|
|
Added
|
|
- Added remote devices.json and languages.json support for Device Simulator.
|
|
- Device and language lists are fetched from a configurable Google Drive URL on open and cached for offline use, with built-in defaults as fallback.
|
|
- Device Simulator remote JSON URLs are configurable in VS Code extension settings (hplToolbox.deviceSimulator.devicesUrl / languagesUrl).
|
|
- Settings modal in standalone — accessible from any page via the ⚙ button, with Device Simulator and Initialize Project sections highlighted when opened from those tools.
|
|
- Device list is now sorted alphabetically in both extension and standalone.
|
|
|
|
Changed
|
|
- Device Simulator settings gear now opens the VS Code extension settings (extension) or the global settings modal (standalone).
|
|
- Device management (add/edit/delete/reorder) removed from Device Simulator in both extension and standalone; device list is now managed via remote JSON.
|
|
- Settings page in standalone replaced by a modal overlay available on every page.
|
|
- Initialize Project manifest URL is now configured via the settings modal instead of the inline settings panel.
|
|
|
|
Fixed
|
|
- Fixed Device Simulator not appearing in the VS Code extension launcher due to a trailing comma in tools.json causing JSON.parse to fail and fall back to a hardcoded list that excluded it.
|
|
```
|