Integrasikan aplikasi iOS - Application Real-Time Monitoring Service

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

Penting

Parameter integrasi untuk software development kit (SDK) berubah pada versi 2.0.0 dan tidak kompatibel dengan versi sebelumnya. Jika Anda melakukan upgrade ke versi 2.0.0 atau yang lebih baru, Anda harus mengikuti dokumen integrasi terbaru untuk memperbarui SDK guna memastikan inisialisasi SDK dilakukan dengan benar.

Langkah 1: Integrasikan SDK

Integrasi otomatis Cocoapods (Direkomendasikan)

Tambahkan versi terbaru SDK ke Podfile proyek Xcode Anda.

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

target 'iOSDemo' do
  # Comment the next line if you're not using Swift and don't want to use dynamic frameworks
  use_frameworks!

  # Import Alibaba Cloud ARMS RUM SDK
  pod 'AlibabaCloudRUM', '2.0.2'
end

Di direktori root proyek atau direktori tempat Podfile berada, jalankan perintah berikut untuk memperbarui pods Anda.
```
pod install --repo-update
```

Integrasi manual

Unduh SDK dan ekstrak file tersebut.
Setelah mengekstrak file .zip, Anda akan memperoleh konten 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 framework yang telah Anda unduh pada langkah sebelumnya, lalu klik Add.
  Catatan
  Langkah-langkah ini mungkin sedikit berbeda tergantung pada versi Xcode.
  Pilih opsi Copy files to destination.
2. Pada pengaturan proyek, buka target > Build Phases > Link Binary With Libraries dan tambahkan library dependensi berikut.
  - libc++.tbd (Wajib)
  - libresolv.tbd (Wajib)
3. Buka target > Build Settings, cari Other Linker Flags, lalu tambahkan flag kompilasi -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

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.

Validasi integrasi

Setelah menjalankan aplikasi, pesan `AlibabaCloudRUMSDK init success` di konsol menunjukkan bahwa SDK berhasil diinisialisasi. Output-nya sebagai berikut:

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