IoT Platform：Tambahkan paket pembaruan

Prosedur

1. Masuk ke Konsol IoT Platform.

2. Di halaman Overview, klik All environment. Pada tab Semua Lingkungan, temukan instance yang ingin Anda kelola dan klik ID atau nama instance.

3. Di panel navigasi sisi kiri, pilih Maintenance > OTA Update.

   Catatan

   Untuk memberikan pengalaman pengguna yang lebih baik, IoT Platform meningkatkan fitur pembaruan OTA dan menyediakan statistik versi paket pembaruan. Pertama kali Anda menggunakan fitur pembaruan OTA baru di Konsol IoT Platform, Anda harus mengaitkan paket pembaruan yang diunggah dengan produk. Anda dapat mengaitkan paket pembaruan hanya dengan satu produk. Untuk informasi lebih lanjut tentang cara mengaitkan paket pembaruan dengan produk, lihat petunjuk di konsol.

4. Opsional. Jika chip AliOS Things dipasang pada perangkat Anda, Anda dapat mengaktifkan fitur pembaruan aman.

   Untuk memastikan integritas dan keamanan paket pembaruan, kami sarankan Anda mengaktifkan fitur pembaruan aman. Jika Anda menggunakan fitur pembaruan aman, verifikasi paket pembaruan dan tanda tangan paket pembaruan perangkat. Untuk informasi lebih lanjut, lihat Tutorial OTA untuk AliOS Things.

   1. Di halaman OTA Update, klik Secure Update.

   2. Di panel Pembaruan Aman, temukan produk yang ingin diperbarui, lalu aktifkan sakelar di kolom Secure Update.

      Ketika fitur pembaruan aman dalam status Activated, klik Copy di kolom Kunci Publik untuk menyalin kunci publik. Anda dapat menggunakan kunci publik untuk memverifikasi tanda tangan perangkat.

5. Opsional. Buat modul OTA kustom.

   Modul OTA adalah modul perangkat yang akan diperbarui dalam suatu produk. Modul OTA mencakup firmware, perangkat lunak, dan driver. Modul default adalah firmware perangkat. Anda juga dapat membuat modul OTA kustom.

   Di tab Modules, klik Add Module. Di kotak dialog Tambah Modul, konfigurasikan parameter dan klik OK. Tabel berikut menjelaskan parameter tersebut.

   Parameter	Deskripsi
   Produk	Produk tempat modul tersebut dimiliki.
   Nama Modul	Nama modul. Nama modul harus unik dalam suatu produk. Setelah modul dibuat, nama tidak dapat diubah. Nama modul harus memiliki panjang 1 hingga 64 karakter, dan dapat berisi huruf, angka, titik (.), tanda hubung (-), dan garis bawah (_).
   Alias Modul	Alias modul. Alias harus memiliki panjang 4 hingga 64 karakter, dan dapat berisi huruf, angka, titik (.), tanda hubung (-), dan garis bawah (_).
   Deskripsi Modul	Deskripsi modul. Deskripsi harus memiliki panjang 1 hingga 100 karakter.

6. Di halaman OTA Update, klik tab Update Packages dan klik Add Update Package.

7. Di kotak dialog Tambah Paket Pembaruan, konfigurasikan parameter, unggah file paket pembaruan, lalu klik OK. Tabel berikut menjelaskan parameter tersebut.

   Parameter	Deskripsi
   Jenis Paket Pembaruan	Jenis paket pembaruan. Nilai valid: Lengkap dan Diferensial. Jika Anda memilih Lengkap, Anda harus mengunggah paket pembaruan lengkap. IoT Platform mendorong paket pembaruan lengkap ke perangkat. Jika Anda memilih Diferensial, Anda harus mengunggah file yang hanya berisi perbedaan antara paket pembaruan versi sebelumnya dan paket pembaruan versi baru. IoT Platform mendorong perbedaan tersebut ke perangkat. Kemudian, perbedaan tersebut digabungkan ke dalam paket pembaruan asli. Pembaruan diferensial menghemat sumber daya perangkat dan mengurangi lalu lintas yang dikonsumsi ketika IoT Platform mendorong paket pembaruan.
   Nama Paket Pembaruan	Nama paket pembaruan. Nama tersebut harus unik dalam akun Alibaba Cloud. Setelah paket pembaruan ditambahkan, nama tidak dapat diubah. Nama harus memiliki panjang 1 hingga 40 karakter, dan dapat berisi huruf, angka, tanda hubung (-), garis bawah (_), dan tanda kurung (). Nama harus dimulai dengan huruf atau angka. Setelah Anda menambahkan paket pembaruan, Anda dapat mengklik Edit di tab Update Package Information pada halaman Update Package Details untuk mengubah nama paket pembaruan.
   Produk	Produk tempat paket pembaruan tersebut dimiliki.
   Modul Paket Pembaruan	Modul OTA tempat paket pembaruan berlaku. Anda dapat mengklik Add Module. Di kotak dialog Tambah Modul, konfigurasikan parameter dan klik OK. Tabel berikut menjelaskan parameter tersebut.
   Versi Paket Pembaruan	Nomor versi paket pembaruan. Nomor versi harus memiliki panjang 1 hingga 64 karakter, dan dapat berisi huruf, angka, titik (.), tanda hubung (-), dan garis bawah (_). Parameter ini diperlukan hanya jika Anda mengatur parameter Jenis Paket Pembaruan ke Full.
   Nomor Versi yang Akan Ditingkatkan	Nomor versi untuk modul OTA perangkat yang akan diperbarui. Daftar drop-down menampilkan versi modul OTA dari semua perangkat dalam produk saat ini. Anda dapat memilih versi dari daftar drop-down. Parameter ini diperlukan jika Anda mengatur parameter Jenis Paket Pembaruan ke Differential.
   Nomor Versi Pasca-Peningkatan	Nomor versi paket pembaruan. Parameter ini diperlukan jika Anda mengatur parameter Jenis Paket Pembaruan ke Differential.
   Algoritma Tanda Tangan	Algoritma tanda tangan. Nilai valid: MD5 dan SHA256. Jika Anda menggunakan Link SDK for Android dan mengatur parameter Jenis Paket Pembaruan ke Differential, pilih algoritma MD5.
   Pilih Paket Pembaruan	File paket pembaruan yang akan diunggah. Anda dapat mengunggah maksimal 20 file. Ukuran total file tidak boleh melebihi 1.000 MB. Format file dapat berupa .bin, .dav, .tar, .gz, .zip, .gzip, .apk, .tar.gz, .tar.xz, atau .pack. Saat Anda mengunggah beberapa file paket pembaruan, perhatikan hal-hal berikut: Setiap nama file harus unik dan tidak boleh melebihi 32 karakter. IoT Platform memeriksa apakah tanda tangan dari beberapa file paket pembaruan sama. Jika tanda tangannya sama, IoT Platform menentukan bahwa file tersebut duplikat.
   Verifikasi Paket Pembaruan?	Menentukan apakah akan memverifikasi paket pembaruan pada beberapa perangkat sebelum Anda melakukan pembaruan massal. Nilai valid: Yes: Anda hanya dapat melakukan pembaruan massal setelah paket pembaruan diverifikasi. No: Anda dapat melakukan pembaruan massal tanpa perlu memverifikasi paket pembaruan.
   Deskripsi Paket Pembaruan	Deskripsi paket pembaruan. Deskripsi dapat memiliki panjang hingga 1.024 karakter. Setelah Anda menambahkan paket pembaruan, Anda dapat mengklik Edit di tab Update Package Information pada halaman Update Package Details untuk mengubah deskripsi paket pembaruan.
   Informasi Kustom yang Dikirim ke Perangkat	Informasi kustom yang ingin Anda kirim ke perangkat. Setelah Anda menambahkan paket pembaruan dan membuat tugas pembaruan, IoT Platform mengirimkan informasi kustom ke perangkat yang ditentukan ketika IoT Platform mendorong notifikasi pembaruan. Informasi kustom dapat memiliki panjang hingga 4.096 karakter. Tidak ada batasan yang diterapkan pada konten atau format. Setelah Anda menambahkan paket pembaruan, Anda dapat mengklik Edit di tab Update Package Information pada halaman Update Package Details untuk mengubah informasi kustom.

Hasil

Setelah Anda menambahkan paket pembaruan, Anda dapat melihat paket pembaruan di tab Update Packages, seperti yang ditunjukkan pada gambar berikut.

Informasi tambahan

Jika Anda mengatur parameter Verify Update Package? ke Yes saat menambahkan paket pembaruan, Anda harus memverifikasi paket pembaruan sebelum melakukan pembaruan massal. Untuk informasi lebih lanjut, lihat Verifikasi Paket Pembaruan (Opsional).

Jika Anda mengatur parameter Verifikasi Paket Pembaruan? ke Tidak saat menambahkan paket pembaruan, Anda dapat melakukan pembaruan massal tanpa perlu memverifikasi paket pembaruan. Untuk informasi lebih lanjut, lihat Mulai Pembaruan Massal.

Opsional: Hapus paket pembaruan

1. Di tab Update Packages, temukan paket pembaruan dan klik Delete di kolom Actions.

2. Di pesan yang muncul, klik OK.

Operasi terkait

Untuk informasi lebih lanjut tentang operasi API terkait fitur pembaruan OTA, lihat Pembaruan OTA.