Mobile Platform as a Service：Beralih ruang kerja

mPaaS menyediakan dua metode untuk beralih lingkungan dengan mudah selama pengembangan:

• Static environment switch

• Dynamic environment switch

Static environment switch

Prasyarat

Anda memiliki aplikasi yang dikembangkan di framework mPaaS. Untuk informasi lebih lanjut, lihat Getting Started with the mPaaS Framework.

Anda dapat menggunakan easyconfig untuk beralih lingkungan secara statis. Tool ini melakukan tindakan berikut:

• Memodifikasi properti meta yang terkait dengan ruang kerja dalam AndroidManifest.

• Memodifikasi file mpaas.properties di direktori assets.

• Jika file konfigurasi proyek mPaaS berisi properti base64 yang tidak kosong, tool ini akan menghasilkan gambar terenkripsi Security Guard yw_1222.jpg.

Public cloud

Untuk beralih ruang kerja di lingkungan public cloud, ikuti langkah-langkah berikut:

1. Pastikan file build.gradle di direktori root proyek memiliki dependensi berikut:

   Catatan

   Versi dependensi ini mungkin berubah pada pembaruan mendatang.

    classpath 'com.alipay.android:android-gradle-plugin:3.0.0.9.13'
    // Nomor versi harus lebih besar dari 2.8.4
    classpath 'com.android.boost.easyconfig:easyconfig:2.8.4'

2. Pastikan file build.gradle dari proyek utama (android main module) memiliki konfigurasi berikut. Perhatikan urutannya:

    apply plugin: 'com.alipay.portal'
    // Letakkan ini setelah com.alipay.portal
    apply plugin: 'com.alipay.apollo.baseline.update'

3. Unduh file konfigurasi .config untuk ruang kerja target dari Konsol. Untuk informasi lebih lanjut, lihat Create an application in console > Download the configuration file.

4. Tambahkan file .config yang telah diunduh ke path proyek utama (android main module). Gambar berikut menunjukkan contohnya:

   

   Penting

   Hanya simpan file konfigurasi untuk ruang kerja saat ini.

Apsara Stack

Di lingkungan Apsara Stack, ikuti langkah-langkah berikut untuk beralih ruang kerja:

1. Pastikan file build.gradle di direktori root proyek memiliki dependensi berikut:

   Catatan

   Versi dependensi ini mungkin berubah pada pembaruan mendatang.

    classpath 'com.alipay.android:android-gradle-plugin:3.0.0.9.13'
    // Nomor versi harus lebih besar dari 2.8.4
    classpath 'com.android.boost.easyconfig:easyconfig:2.8.4'

2. Pastikan file build.gradle dari proyek utama (android main module) memiliki konfigurasi berikut. Perhatikan urutannya:

    apply plugin: 'com.alipay.portal'
    // Letakkan ini setelah com.alipay.portal
    apply plugin: 'com.alipay.apollo.baseline.update'

3. Unduh file konfigurasi .config untuk ruang kerja target dari Konsol. Untuk informasi lebih lanjut, lihat Download the configuration file.

4. Tambahkan file .config yang telah diunduh ke path proyek utama (android main module). Gambar berikut menunjukkan contohnya:

   

   Penting

   Hanya simpan file konfigurasi untuk ruang kerja saat ini.

5. Gunakan plugin mPaaS untuk menghasilkan gambar terenkripsi yw_1222.jpg. Untuk informasi lebih lanjut, lihat Encrypted images (Apsara Stack).

Dynamic environment switch

Dynamic environment switching memungkinkan Anda mengubah informasi lingkungan aplikasi dengan memodifikasi opsi lingkungan di pengaturan ponsel tanpa perlu repackaging client.

Pembaruan informasi konfigurasi lingkungan akan memodifikasi gambar verifikasi signature Security Guard (yw_1222.jpg). Karena keterbatasan mekanisme verifikasi signature keamanan mPaaS, dynamic environment switching memiliki dua batasan berikut:

• Metode ini hanya berlaku selama fase pengembangan. Sebelum merilis aplikasi, Anda harus menghapus konfigurasi terkait. Jika tidak, paket rilis akan menghasilkan RuntimeException.

• Anda harus menonaktifkan sakelar verifikasi signature permintaan jaringan di Konsol mPaaS. Jika tidak, permintaan akan gagal karena informasi gambar signature tidak sesuai.

  

Tambahkan SDK dynamic environment switch

1. Tambahkan dependensi.

   • Untuk jenis koneksi native AAR, tambahkan dependensi berikut ke bagian dependencies dalam file build.gradle modul utama proyek:

     dependencies {
     ···
     implementation 'com.mpaas.mocksettings:mocksettings-build:10.1.60a.1575@aar'
     ···
     }

   • Untuk jenis koneksi Portal & Bundle, tambahkan dependensi berikut ke bagian dependencies dalam file build.gradle modul utama proyek Portal:

     dependencies {
     ···
     bundle 'com.mpaas.mocksettings:mocksettings-build:1.0.0.200421111458@jar'
     manifest 'com.mpaas.mocksettings:mocksettings-build:1.0.0.200421111458:AndroidManifest@xml'
     ···
     }

2. Gunakan SDK.

   • Untuk jenis koneksi native AAR, tulis ulang metode getPackageManager pada Application dan ganti PackageManager dengan MockSettingsPackageManager.

     private MockSettingsPackageManager mockSettingsPackageManager;
     
     @Override
     public PackageManager getPackageManager() {
         if (mockSettingsPackageManager == null) {
             mockSettingsPackageManager = new MockSettingsPackageManager(this, super.getPackageManager());
         }
         return mockSettingsPackageManager;
     }

   • Untuk jenis koneksi Portal & Bundle, ubah application dalam file AndroidManifest.xml modul utama proyek Portal menjadi seperti berikut:

     <application
          android:name="com.alipay.mobile.quinox.MockSettingsLauncherApplication"
          ···
          >
          ···
     </application>

3. Tambahkan izin berikut dan pastikan izin tersebut diminta secara dinamis saat runtime:

   <uses-permission android:name="android.permission.READ_EXTERNAL_STORAGE" />

4. Kompilasi paket debug atau aktifkan pengaturan debug di AndroidManifest.xml:

   <application
        android:debuggable="true"
        ···
        >
        ···
   </application>

Dynamic switching

1. Pindai kode QR untuk mengunduh aplikasi mPaaS Settings.

   Setelah instalasi, ikon aplikasi mPaaS Settings akan tampak seperti berikut:

   

2. Salin file config yang telah Anda unduh dari Konsol mPaaS ke kartu SD atau penyimpanan internal ponsel Anda.

3. Tambahkan lingkungan. Gunakan aplikasi mPaaS Settings untuk menambahkan file config ke daftar.

   1. Buka aplikasi mPaaS Settings.

   2. Pada halaman Environment List, ketuk Add Environment Configuration File di bagian bawah.

   3. Cari file konfigurasi lingkungan yang ingin Anda tambahkan.

      

   4. Tambahkan file untuk lingkungan produksi dan staging ke daftar lingkungan.

4. Beralih lingkungan.

   1. Pilih lingkungan dari daftar dan ketuk Switch untuk menjadikannya lingkungan saat ini.

   2. Jalankan aplikasi untuk lingkungan tersebut. Jika permintaan uji berhasil dikirim, pergantian lingkungan telah berhasil.

      Jika Anda beralih ke lingkungan lain dan restart aplikasi, sistem mungkin melaporkan error 3000. Error ini terjadi karena operationType dari lingkungan sebelumnya tidak ada di lingkungan baru, yang mengonfirmasi bahwa pergantian telah berhasil.