Skip to content

Load remote Mini App

1. Description

Load the mini-app from any URL that uploaded the mini-app. And use the feature hot refresh to load the new version mini app. After that, you can debug and test mini-apps.

2. Usage

Step 1: Build Mini App bundles:

  • Go to the root of the mini-app project, the open terminal here:
  • Run command build bundles:
v99-cli app bundle

See more.

Step 2: Upload Mini App bundles:

  • Go to folder build bundles of Mini App: /build/outputs/ios/remotes or /build/outputs/android/remotes
  • Upload files: [ContainerName].container.bundle and src_[ContainerName]_tsx.chunk.bundle to your URL.

Step 3: Generate a QR code from the remote URL that you uploaded 2 files bundled in step 1

  • Go to the root of the mini-app project, and open the terminal here.
  • Run the command to generate the QR Code with URL that container 2 files bundle in step 1:
v99-cli gen-qr

See more.

v99-cli app start

Step 4: Scan QR via V99 Sandbox

  • Press the QR Code icon ic_qrscan.png at the right header bar of V99 Sandbox app.
  • Let's scan the QR code generated in step 3.
  • If there are no any errors, the V99 Sandbox app will show the loading mini-app project.
  • Wait a moment and you can see the mini app loaded in the V99 Sandbox app.

Device screen:

bundle-loading