Integrasikan Aplikasi iOS - Application Real-Time Monitoring Service

Real User Monitoring menyediakan kemampuan pemantauan aplikasi seluler yang komprehensif untuk mendukung pemantauan dan analisis waktu nyata terhadap metrik kunci, seperti performa aplikasi, crash, dan tersendat. Topik ini menjelaskan cara mengintegrasikan aplikasi iOS.

Penting

Parameter integrasi SDK berubah pada versi 2.0.0. Versi 2.0.0 dan yang lebih baru tidak kompatibel dengan versi sebelumnya. Jika Anda melakukan upgrade ke versi 2.0.0 atau yang lebih baru, Anda harus mengikuti dokumentasi integrasi terbaru untuk meng-upgrade SDK guna memastikan inisialisasi SDK berjalan dengan benar.

Langkah 1: Integrasikan SDK

Integrasi Otomatis Menggunakan CocoaPods (Direkomendasikan)

Tambahkan versi SDK terbaru ke Podfile proyek Xcode Anda.

source 'https://github.com/CocoaPods/Specs.git'

target 'iOSDemo' do
  # Beri komentar pada baris berikut jika Anda tidak menggunakan Swift dan tidak ingin menggunakan dynamic frameworks
  use_frameworks!

  # Impor Alibaba Cloud ARMS RUM SDK
  pod 'AlibabaCloudRUM', '2.2.2'
end

Di direktori root proyek Anda atau direktori yang berisi Podfile, jalankan perintah berikut untuk memperbarui lingkungan CocoaPods Anda.
```
pod install --repo-update
```

Integrasi Manual

Unduh SDK dan ekstrak file ZIP tersebut.
Setelah mengekstrak file ZIP, Anda akan menemukan file-file berikut:
- AlibabaCloudRUM.xcframework
- AlibabaCloudRUMSDK.xcframework
Konfigurasikan proyek.
1. Di Xcode, pilih File > Add Files to "Your Project Name".... Pada kotak dialog yang muncul, pilih dua paket framework yang telah Anda unduh pada langkah sebelumnya, lalu klik Add.
  Catatan
  Versi Xcode mungkin sedikit berbeda.
  Kami menyarankan Anda memilih opsi Copy files to destination.
2. Pada pengaturan proyek Anda, buka target > Build Phases > Link Binary With Libraries, lalu tambahkan library dependensi berikut:
  - libc++.tbd (wajib)
  - libresolv.tbd (wajib)
3. Pada pengaturan proyek Anda, buka target > Build Settings. Cari Other Linker Flags dan tambahkan flag linker -ObjC.
  Penting
  Pastikan penulisan -ObjC benar.

Langkah 3: Impor File Header

Impor file header di main.m atau AppDelegate.m.

Objective-C

@import AlibabaCloudRUM;

Swift

import AlibabaCloudRUM

Langkah 4: Inisialisasi SDK

Lakukan inisialisasi SDK di fungsi main atau metode application:didFinishLaunchingWithOptions:.

Objective-C

[AlibabaCloudRUM setEndpoint:@"<your endpoint>"];// Dapatkan endpoint saat membuat aplikasi RUM
[AlibabaCloudRUM setWorkspace:@"<your workspace>"];// Dapatkan workspace saat membuat aplikasi RUM
[AlibabaCloudRUM start:@"<your serviceId>"];// Dapatkan ServiceId saat membuat aplikasi RUM

Swift

AlibabaCloudRUM.setEndpoint("<your endpoint>")// Dapatkan endpoint saat membuat aplikasi RUM
AlibabaCloudRUM.setWorkspace:("<your workspace>")// Dapatkan workspace saat membuat aplikasi RUM
AlibabaCloudRUM.start("<your serviceId>")// Dapatkan ServiceId saat membuat aplikasi RUM

Verifikasi Integrasi

Setelah menjalankan kode, konsol akan menampilkan "AlibabaCloudRUMSDK init success", yang menunjukkan bahwa SDK berhasil diinisialisasi. Output-nya sebagai berikut:

[AlibabaCloudRUM] [INFO   ] [RUM] <start> AlibabaCloud RUM init success