Gunakan SDK - Mobile Platform as a Service

Setelah menambahkan SDK, ikuti langkah-langkah berikut untuk menghubungkan layanan pengiriman ke klien iOS:

Deteksi versi baru: Panggil metode API SDK dalam kode untuk memeriksa apakah versi baru tersedia.
Konfigurasikan daftar putih rilis abu-abu: Konfigurasikan fungsi seperti pengingat pembaruan dan rilis abu-abu.
Penting
Jika dependensi UTDID dihapus, rilis abu-abu jendela waktu tidak akan berlaku.
Rilis online: Hasilkan file .ipa di konsol mPaaS, lalu rilis versi baru.

Prosedur

Deteksi versi baru

SDK deteksi peningkatan menyediakan file API untuk memeriksa peningkatan App yang tersedia. File header metode tersebut terletak di AliUpgradeCheckService.framework > Headers > MPCheckUpgradeInterface.h.

typedef NS_ENUM(NSUInteger, AliUpdateType) {
    AliUpgradeNewVersion = 201,           /*Versi terbaru saat ini sedang digunakan.*/
    AliUpgradeOneTime,                     /*Versi baru klien tersedia, dan pengingat tunggal dikirim.*/
    AliUpgradeForceUpdate,                 /*Versi baru klien tersedia, dan peningkatan paksa diterapkan (tidak digunakan lagi).*/
    AliUpgradeEveryTime,                   /*Versi baru klien tersedia, dan beberapa pengingat dikirim.*/
    AliUpgradeRejectLogin,                 /*Login dibatasi (tidak digunakan lagi)*/
    AliUpgradeForceUpdateWithLogin         /*Versi baru klien tersedia, dan peningkatan paksa diterapkan.*/
};

/**
 Callback sukses dari deteksi peningkatan selama penyesuaian UI

 @param upgradeInfos Informasi peningkatan
 @{upgradeType:202,
 downloadURL:@"itunes://downLoader.xxxcom/xxx",
 message:@"Versi baru tersedia, silakan tingkatkan",
 upgradeShortVersion:@"9.9.0",
 upgradeFullVersion:@"9.9.0.0000001"
 needClientNetType:@"4G,WIFI",
 userId:@"admin"
 }
 */
typedef void(^AliCheckUpgradeComplete)(NSDictionary *upgradeInfos);
typedef void(^AliCheckUpgradeFailure)(NSException *exception);


@interface MPCheckUpgradeInterface : NSObject

/**
 Interval antara dua pengingat tunggal, dalam hari. Nilai default: 3.
 */
@property(nonatomic, assign) NSTimeInterval defaultUpdateInterval;

/**
 Modifikasi proxy UI dari jendela pop-up default.
 */
@property (nonatomic, weak) id<AliUpgradeViewDelegate> viewDelegate;

/**
 * Inisialisasi instance.
 */
+ (instancetype)sharedService;

/**
 Deteksi pembaruan secara proaktif. Jika ada pembaruan, prompt default mPaaS ditampilkan di pop-up.
 *
 */
- (void)checkNewVersion;

/**
 Deteksi pembaruan secara proaktif. Tidak ada pop-up yang ditampilkan. Metode ini biasanya digunakan untuk penyesuaian UI, deteksi pembaruan, dan pengingat titik merah.

 @param complete Callback berhasil, dan kamus informasi peningkatan dikembalikan.
 @param failure Callback gagal.
 */
- (void)checkUpgradeWith:(AliCheckUpgradeComplete)complete
                 failure:(AliCheckUpgradeFailure)failure;
@end

Pengembang dapat memanggil API yang sesuai untuk mendeteksi pembaruan setelah App dimulai. Kami merekomendasikan pemanggilan API setelah halaman utama ditampilkan agar waktu mulai App tidak terpengaruh. Berikut tiga metode pemanggilan disediakan untuk kebutuhan UI yang berbeda dalam menampilkan informasi prompt peningkatan:

Gunakan pop-up default mPaaS untuk menampilkan informasi prompt peningkatan.

 - (void)checkUpgradeDefault {
      [[MPCheckUpgradeInterface sharedService] checkNewVersion];
  }

Sesuaikan ikon pop-up, toast prompt jaringan, atau bilah kemajuan permintaan jaringan berdasarkan pop-up default mPaaS.

 - (void)checkUpgradeWithHeaderImage {
      MPCheckUpgradeInterface *upgradeInterface = [MPCheckUpgradeInterface sharedService];
      upgradeInterface.viewDelegate = self;
      [upgradeInterface checkNewVersion];
  }

  - (UIImage *)upgradeImageViewHeader{
      return APCommonUILoadImage(@"ilustration_ap_expection_alert");
  }

  - (void)showToastViewWith:(NSString *)message duration:(NSTimeInterval)timeInterval {
      [self showAlert:message];
  }

  - (void)showAlert:(NSString*)message {
      AUNoticeDialog* alertView = [[AUNoticeDialog alloc] initWithTitle:@"Informasi" message:message delegate:nil cancelButtonTitle:@"OK" otherButtonTitles:nil, nil];
      [alertView show];
  }

Panggil API berikut untuk mendapatkan informasi peningkatan dan sesuaikan UI jika gaya pop-up yang disediakan oleh mPaaS tidak memenuhi kebutuhan Anda.

 - (void)checkUpgradeWIthCustomUI {
      [[MPCheckUpgradeInterface sharedService] checkUpgradeWith:^(NSDictionary *upgradeInfos) {
          [self showAlert:[upgradeInfos JSONString]];
      } failure:^(NSException *exception) {
      }];
  }

Konfigurasikan daftar putih rilis abu-abu

Untuk menggunakan fungsi rilis abu-abu daftar putih dalam manajemen rilis, pastikan Anda telah memperoleh identitas unik klien di server. Konfigurasikan identitas pengguna unik dalam kategori MPaaSInterface di klien, dan kembalikan identitas unik App di metode userId, misalnya nama pengguna, nomor telepon, alamat email, dll.

@implementation MPaaSInterface (Portal)

- (NSString *)userId
{
    return @"mPaaS";
}

@end

Untuk detail tentang cara mengonfigurasi daftar putih di konsol mPaaS, lihat Layanan Pengiriman > Kelola daftar putih.

Rilis online

Hasilkan file .ipa

Gunakan Xcode untuk menghasilkan paket instalasi .ipa.
Atau, hasilkan paket instalasi .ipa dengan fungsi pengemasan yang disediakan oleh plugin mPaaS. Paket yang dihasilkan akan disimpan di direktori product di bawah proyek Anda saat ini.
- Bundle Identifier: Harus konsisten dengan bundle Id di file konfigurasi cloud.
- Bundle Version: Harus konsisten dengan info.plist di file Production Version untuk proyek.
- Provisioning Profile: File konfigurasi tanda tangan. Harus konsisten dengan bundle Id; jika tidak, pembuatan paket akan gagal.
- Debug: Menentukan apakah akan menghasilkan paket instalasi debug.
- App Store: Menentukan apakah akan menghasilkan paket untuk dirilis di App Store.

Rilis versi baru

Gunakan fungsi manajemen rilis platform rilis untuk merilis versi baru. Untuk detail tentang proses rilis, lihat Manajemen rilis.

Mode peningkatan:

Saat membuat tugas rilis di konsol mPaaS, pilih salah satu dari tiga mode peningkatan berikut:

Pengingat tunggal: Setelah versi baru dirilis di konsol mPaaS, klien memanggil API peningkatan versi sekali dan menampilkan pop-up hanya sekali selama periode diam untuk menghindari mengganggu pengguna.
- Mode peningkatan ini cocok untuk menginstruksikan pengguna melakukan peningkatan setelah versi baru dirilis.
- Secara default, periode diam adalah 3 hari, selama mana pengguna hanya diberitahu sekali. Untuk mengubah durasi periode diam, atur atribut berikut sebelum memanggil API deteksi peningkatan:
```
 - (void)checkUpgradeDefault {
   [MPCheckUpgradeInterface sharedService].defaultUpdateInterval = 7;
   [[MPCheckUpgradeInterface sharedService] checkNewVersion];
   }
```
Pengingat berulang: Setelah versi baru dirilis di konsol mPaaS, klien menampilkan pengingat pop-up setiap kali memanggil API peningkatan versi. Mode peningkatan ini cocok untuk menginstruksikan pengguna meningkatkan App ke versi baru sesegera mungkin setelah versi baru dirilis selama periode tertentu.
Pengingat wajib: Setelah versi baru dirilis di konsol mPaaS, klien menampilkan pengingat pop-up tanpa tombol Batal setiap kali memanggil API peningkatan versi. Pengguna tidak dapat lagi menggunakan App tanpa peningkatan. Mode peningkatan ini cocok untuk memaksa pengguna meningkatkan App ke versi baru dan menarik versi App sebelumnya.

Contoh kode