全部产品
Search
文档中心

Mobile Platform as a Service:Buat paket offline HTML5

更新时间:Feb 05, 2026

Untuk membuat paket offline HTML5, Anda harus memasukkan informasi dasar dan konfigurasi.

Prasyarat

Anda harus telah mengonfigurasi paket offline HTML5 di halaman Configuration Management. Untuk informasi selengkapnya, lihat Configure an offline package.

Tentang tugas ini

Anda dapat membuat paket offline HTML5 satu per satu atau membuat beberapa paket sekaligus menggunakan fitur batch import.

Saat mengunggah paket offline untuk H5App pertama kali, Anda harus memilih tipe paket. Pilihan ini tidak dapat diubah nanti. Setiap H5App hanya dapat memiliki satu tipe paket.

Prosedur

Buat satu paket offline

Masuk ke konsol mPaaS dan ikuti langkah-langkah berikut:

  1. Pada panel navigasi kiri, pilih Mobile Delivery Service> Offline package management.

  2. Pada halaman Offline Package Management, klik Create an HTML5 App. (Jika Anda telah membuat H5App, lewati langkah ini.)

  3. Pada jendela Create an HTML5 App , masukkan HTML5 App ID dan HTML5 App name, lalu klik OK. (Jika Anda telah membuat H5App, lewati langkah ini.)

    Penting
    • ID H5App harus berupa angka 8 digit.

    • ID 20000196, 66666692, 68687029, dan 68687209 telah tertanam dalam software development kit (SDK). Jangan gunakan ID-ID tersebut untuk H5App Anda agar tidak terjadi konflik.

    • Jangan gunakan ID H5App yang diawali dengan 666666 atau 20000.

  4. Pilih aplikasi HTML5 dari daftar HTML5 app, lalu klik Add an offline package di sebelah kanan.

  5. Pada bagian Basic Information, konfigurasikan parameter berikut:

    • Resource package type: Pilih Global resource package atau Normal resource package.

      Catatan

      Jika Anda menggunakan global resource pack, ubah nama direktori tingkat kedua dalam global resource pack menjadi mcube-prod.mpaascloud.com; jika tidak, Anda tidak akan dapat menggunakan kemampuan akselerasi dari real-time release docking.

    • HTML5 app version: Masukkan versi paket offline, misalnya 1.0.0.1.

    • File: Unggah file paket offline dalam format .zip.

    • Client version: Pilih jenis perangkat klien dan atur rentang versi. Hanya klien dalam rentang versi tersebut yang dapat menerima paket offline baru.

      Catatan
      • Minimal satu jenis klien diperlukan. Jika Android dan iOS keduanya dipilih, pastikan kedua klien menerapkan strategi yang sama untuk versi terbaru. Secara spesifik, versi terbaru kedua klien harus dikosongkan (default sistem) atau diatur dengan nilai yang sama.

      • Jika versi terbaru dikosongkan, semua versi mendatang akan didukung. Disarankan untuk membiarkannya sebagai default agar paket offline tidak menjadi tidak efektif ketika versi klien yang ditingkatkan lebih tinggi dari versi yang ditentukan sebelumnya.

      • Versi klien iOS harus lebih lama dari nilai bidang Product Version pada file info.plist proyek.

  6. Pada bagian Configuration Information, konfigurasikan parameter berikut:

    • URL of main entrance: Opsional. Halaman utama paket offline.

      Catatan

      Diperlukan path lengkap, seperti /www/index.html, di mana /www adalah nama direktori tingkat kedua yang Anda sesuaikan sendiri.

    • Virtual domain: Nama domain virtual yang Anda masukkan saat mengonfigurasi paket offline akan ditampilkan secara otomatis.

    • Extended information: Opsional. Masukkan parameter pemuatan halaman dalam format pasangan kunci-nilai (KV). Pisahkan beberapa pasangan KV dengan koma (,).

      Pada platform mPaaS, Anda dapat mengonfigurasi interval permintaan untuk paket offline HTML5. Pengaturan ini dapat diterapkan pada satu paket offline atau secara global.

      • Konfigurasi per paket: Berlaku hanya untuk paket offline saat ini. Pada bidang Extended information , Anda dapat memasukkan {"asyncReqRate":"1800"} untuk mengatur interval permintaan, di mana 1800 menunjukkan interval tersebut. Interval diukur dalam detik dan berkisar antara 0 hingga 86400 detik (0 hingga 24 jam). Nilai 0 berarti tidak ada batasan interval permintaan.

      • Konfigurasi global: Berlaku untuk semua paket offline. Parameter ini ditentukan dalam kode klien. Untuk informasi selengkapnya, lihat Getting started dan Getting started.

    • Time for download: Pilih waktu pengguna mengunduh paket offline.

      • Jika Anda memilih Wi-Fi only, paket offline akan diunduh secara otomatis di latar belakang hanya saat terhubung ke Wi-Fi.

      • Jika Anda memilih All networks, paket offline tetap akan diunduh secara otomatis melalui jaringan non-Wi-Fi, sehingga akan mengonsumsi kuota data pengguna. Oleh karena itu, atur opsi ini dengan hati-hati.

    • Time of installation: Pilih waktu pemasangan paket offline.

      • Jika Anda memilih Not preload, paket offline hanya akan dipasang saat paket offline tersebut dibuka.

      • Jika Anda memilih Preload, paket offline akan dipasang secara otomatis setelah proses pengunduhan selesai.

  7. Pilih kotak centang I confirm the above information is accurate, lalu klik Submit untuk menyelesaikan pembuatan paket offline.

Impor paket offline secara batch

Untuk membuat beberapa paket offline sekaligus, Anda dapat mengimpornya secara batch. Metode ini meningkatkan efisiensi penerbitan dan membantu mencegah kesalahan konfigurasi.

  • Setelah impor, jika H5App tempat paket offline tersebut bernaung belum ada, H5App baru akan dibuat secara default.

  • Jika H5App tempat paket offline tersebut bernaung sudah ada, paket offline akan ditambahkan ke H5App tersebut setelah dikonfigurasi.

Masuk ke konsol mPaaS dan ikuti langkah-langkah berikut:

  1. Pada panel navigasi kiri, pilih Mobile Delivery Service> Offline package management, lalu klik Batch import HTML5 app.

  2. Pada jendela Batch import HTML5 app, ikuti petunjuk untuk mengunggah file paket offline HTML5 (.zip).

    Catatan
    • Ukuran total file paket offline yang diimpor tidak boleh melebihi 300 MB, dan jumlah paket tidak boleh lebih dari 100.

    • Setiap file resource paket offline harus dinamai sesuai dengan ID paket offline 8 digit yang bersangkutan.

  3. Halaman hasil impor mencantumkan paket offline yang berhasil dimuat. Pada halaman ini, klik Edit di kolom Operation untuk mengedit informasi dasar suatu paket offline. Penjelasan mengenai item konfigurasi tersedia di Create a single offline package.

    Pada halaman hasil impor, nomor versi paket offline mengikuti aturan berikut secara default. Anda dapat mengedit nomor versi tersebut.

    • Jika H5App untuk paket offline belum ada, nomor versi paket yang diimpor akan default ke 0.0.0.1.

    • Jika H5App untuk paket offline sudah ada, nomor versi paket yang diimpor akan default ke nomor versi inkremental berikutnya berdasarkan versi tertinggi yang sudah ada.

  4. Setelah selesai mengedit semua paket offline, pilih kotak centang The information can't be modified after submission, lalu klik Submit. Sistem akan memvalidasi informasi yang dikirimkan. Jika validasi gagal, pesan error akan muncul. Jika validasi berhasil, informasi paket offline HTML5 akan muncul di halaman Offline Package Management, yang menandakan bahwa paket telah berhasil dibuat.

Langkah selanjutnya

Release an offline package