Application Real-Time Monitoring Service:Integrasikan aplikasi iOS

CocoaPods (disarankan)

1. Tambahkan versi terbaru SDK ke file Podfile dalam 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 the Alibaba Cloud RUM SDK
     pod 'AlibabaCloudRUM', '2.4.0'
   end

2. Di direktori root proyek Anda, atau direktori tempat file Podfile berada, jalankan perintah berikut untuk memperbarui lingkungan CocoaPods.

   pod install --repo-update

Integrasi manual

1. Unduh SDK dan ekstrak file .zip tersebut.

   File .zip yang diekstrak berisi:

   • AlibabaCloudRUM.xcframework

   • AlibabaCloudRUMSDK.xcframework

2. Konfigurasikan proyek.

   1. Di Xcode, pilih File > Add Files to "Your Project Name".... Di panel tersebut, pilih dua paket framework dari langkah sebelumnya, lalu klik Add.

      Catatan

      • Antarmuka pengguna mungkin sedikit berbeda tergantung versi Xcode Anda.

      • Kami menyarankan Anda memilih Copy files to destination.

      Di bagian Targets, pilih target proyek Anda, misalnya iOSDemo, lalu klik Finish.

   2. Di pengaturan proyek Anda, navigasikan ke target > Build Phases > Link Binary With Libraries dan tambahkan library dependensi berikut:

      • libc++.tbd (Required)

      • libresolv.tbd (Required)

      Di proyek Xcode Anda, navigasikan ke Build Phases > Link Binary With Libraries dan pastikan library sistem tersebut, AlibabaCloudRUMSDK.xcframework, dan AlibabaCloudRUM.xcframework telah ditambahkan. Pastikan status masing-masing diatur sebagai Required.

   3. Di target > Build Settings, cari Other Linker Flags dan tambahkan flag penghubung -ObjC.

      Penting

      Pastikan penulisan -ObjC benar.

Objective-C

@import AlibabaCloudRUM;

Swift

import AlibabaCloudRUM

Objective-C

// [Recommended] Enable the Session Replay module.
[AlibabaCloudRUM enableModule:AlibabaCloudModuleSessionReplay];

// [Required] Obtain the endpoint when you create a RUM application.
[AlibabaCloudRUM setEndpoint:@"<your endpoint>"];
// [Required] Obtain the workspace when you create a RUM application.
[AlibabaCloudRUM setWorkspace:@"<your workspace>"];
// [Required] Obtain the serviceId when you create a RUM application.
[AlibabaCloudRUM start:@"<your serviceId>"];

// [Recommended] Configure Session Replay. The configuration includes:
// 1. A sample rate of 5%
// 2. Preservation of static text, placeholder text, and normal input
// 3. Preservation of built-in resource images
// 4. Recording of touch positions
AlibabaCloudSessionReplayConfiguration *sessionReplayConfiguration =
[AlibabaCloudSessionReplayConfiguration configurationWithSampleRate:5
                                                textAndInputPrivacy:AlibabaCloudTextAndInputPrivacyMaskSensitiveInputs
                                                       imagePrivacy:AlibabaCloudImagePrivacyMaskNonBundledOnly
                                                       touchPrivacy:AlibabaCloudTouchPrivacyShow];
// [Recommended] Start Session Replay data collection.
[AlibabaCloudSessionReplay startWithConfiguration:sessionReplayConfiguration];

// [Recommended] Enable the session replay module.
AlibabaCloudRUM.enableModule(.sessionReplay)

// [Required] Obtain the endpoint when you create a RUM application.
AlibabaCloudRUM.setEndpoint("<your endpoint>")
// [Required] Obtain the workspace when you create a RUM application.
AlibabaCloudRUM.setWorkspace:("<your workspace>")
// [Required] Obtain the serviceId when you create a RUM application.
AlibabaCloudRUM.start("<your serviceId>")

// [Recommended] Configure Session Replay with the following settings:
// 1. Sample rate: 5%
// 2. Retain static text, placeholder text, and regular input.
// 3. Retain built-in resource images.
// 4. Record touch positions.
let configuration = AlibabaCloudSessionReplayConfiguration(sampleRate: 5,
                                                           textAndInputPrivacy: .maskSensitiveInputs,
                                                           imagePrivacy: .maskNonBundledOnly,
                                                           touchPrivacy: .show)
// [Recommended] Start Session Replay data collection.
AlibabaCloudSessionReplay.start(configuration)

Swift