Files
vsix-hpl-toolbox/README.md
2026-06-23 13:53:55 +08:00

7.4 KiB

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.

v1.0.1

Added
    - Added backup PLEC server (20.255.60.183) as a selectable upload target in PLEC Upload.
    - Server dropdown in the PLEC Upload inputs panel — Default (167.99.227.249) or Backup (20.255.60.183).
    - Backup server uses WordPress authentication (auto-login, nonce fetch) — no manual token management.
    - Iteration name is used as the uploaded filename on the backup server.
    - Selected server persists across sessions (VS Code globalState / localStorage in standalone).

Changed
    - Build scripts moved to scripts/ and added as npm run build and npm run run-standalone.