Bagikan melalui

Mulai menggunakan ekstensi iOS

Penting

Visual Studio App Center dihentikan pada 31 Maret 2025, kecuali untuk fitur Analitik dan Diagnostik, yang akan terus didukung hingga 30 Juni 2026. Pelajari lebih lanjut.

Ekstensi aplikasi hanya mendukung pelaporan crash.

Untuk mempelajari cara menambahkan App Center SDK ke aplikasi kontainer Anda, lihat dokumentasi untuk Memulai App Center iOS.

Mari kita mulai menyiapkan App Center iOS SDK di ekstensi aplikasi Anda untuk menggunakan App Center Crash.

1. Prasyarat

Persyaratan berikut harus dipenuhi untuk menggunakan App Center SDK:

  • Proyek iOS Anda disiapkan di Xcode 13 atau yang lebih baru di macOS versi 10.14.4 atau yang lebih baru.
  • Anda menargetkan perangkat yang berjalan di ios 11.0 atau yang lebih baru.
  • Anda tidak menggunakan pustaka lain yang menyediakan fungsionalitas Pelaporan Kerusakan.

2. Buat aplikasi Anda di Portal App Center untuk mendapatkan Rahasia Aplikasi

Jika Anda sudah membuat aplikasi di portal App Center, Anda dapat melewati langkah ini.

  1. Pergilah ke appcenter.ms.
  2. Daftar atau masuk dan tekan tombol biru di sudut kanan atas portal yang bertuliskan Tambahkan baru dan pilih Tambahkan aplikasi baru dari menu dropdown.
  3. Masukkan nama dan deskripsi opsional untuk aplikasi Anda.
  4. Pilih iOS sebagai OS dan Objective-C/Swift sebagai platform.
  5. Tekan tombol di kanan bawah yang bertuliskan Tambahkan aplikasi baru.

Setelah membuat aplikasi, Anda dapat memperoleh Rahasia Aplikasi di halaman Pengaturan di Portal App Center. Di sudut kanan atas halaman Pengaturan , klik titik vertikal tiga kali dan pilih Copy app secret untuk mendapatkan Rahasia Aplikasi Anda.

Nota

Menggunakan Rahasia Aplikasi yang ada dari proyek iOS lain dapat memiliki konsekuensi. App Center tidak mendukung pemfilteran berdasarkan proyek pada aplikasi App Center yang sama. Misalnya, daftar kerusakan untuk versi tertentu akan mencakup semua kerusakan dari kedua proyek untuk versi ini tanpa perbedaan. Ini bisa membingungkan.

Nota

Versi 4.0.0 dari App Center diperkenalkan perubahan besar. Ikuti bagian Migrasi ke App Center SDK 4.0.0 dan yang lebih tinggi untuk memigrasikan App Center dari versi sebelumnya.

3. Tambahkan modul App Center SDK

App Center SDK dapat diintegrasikan ke dalam aplikasi Anda melalui Cocoapods, Carthage , atau dengan menambahkan biner secara manual ke proyek Anda.

3.1 Integrasi melalui Cocoapods

  1. Tambahkan dependensi-dependensi berikut ke dalam podfile Anda untuk menyertakan App Center Crashes ke dalam aplikasi Anda. Ini menarik kerangka kerja berikut: AppCenter dan AppCenterCrashes.

     pod 'AppCenter/Crashes'

  2. Jalankan pod install untuk menginstal pod yang baru ditentukan dan buka proyek .xcworkspace.

Nota

Jika Anda melihat kesalahan seperti [!] Unable to find a specification for `AppCenter` saat menjalankan pod install, jalankan pod repo update untuk mendapatkan pod terbaru dari repositori Cocoapods lalu jalankan pod install.

Sekarang setelah Anda mengintegrasikan kerangka kerja dalam aplikasi Anda, saatnya untuk memulai SDK dan menggunakan layanan App Center.

3.2 Integrasi melalui Carthage

Di bawah ini adalah langkah-langkah tentang cara mengintegrasikan App Center SDK dalam proyek Xcode Anda menggunakan Carthage versi 0.30 atau yang lebih tinggi, manajer dependensi terdesentralisasi yang membangun dependensi Anda dan memberi Anda kerangka kerja biner.

  1. Tambahkan dependensi berikut ke Cartfile Anda untuk mengintegrasikan App Center ke dalam aplikasi Anda. Ini menarik semua kerangka kerja. Kemudian Anda hanya dapat menautkan kerangka kerja tersebut untuk digunakan di aplikasi Anda.

    # Use the following line to get the latest version of App Center
github "microsoft/appcenter-sdk-apple"

    # Use the following line to get the specific version of App Center
github "microsoft/appcenter-sdk-apple" ~> X.X.X

  2. Jalankan carthage update. Ini mengambil dependensi ke dalam folder Carthage/Checkouts , lalu membangun setiap kerangka kerja.

  3. Buka tab Pengaturan umum target aplikasi Anda. Seret dan letakkan file AppCenter.framework dan AppCenterCrashes.framework dari folder Carthage/Build/ ke Dalam Project Navigator Xcode. AppCenter.framework diperlukan untuk memulai SDK. Jika tidak ditambahkan ke proyek, modul lain tidak akan berfungsi dan aplikasi Anda tidak akan dikompilasi.

  4. Kotak dialog akan muncul, pastikan sasaran aplikasi Anda dicentang. Lalu klik Selesai.

    Nota

    Jika Anda menggunakan carthage copy-frameworks dalam Fase Build , Anda tidak boleh menambahkan SDK App Center di sana, karena dikirim sebagai kerangka kerja statis.

Sekarang setelah Anda mengintegrasikan kerangka kerja dalam aplikasi Anda, saatnya untuk memulai SDK dan menggunakan layanan App Center.

3.3 Integrasi melalui Swift Package Manager

  1. Dari menu Xcode klik File > Paket Swift > Tambahkan Dependensi Paket.
  2. Dalam dialog yang muncul, masukkan URL repositori: https://github.com/microsoft/appcenter-sdk-apple.git.
  3. Di Versi, pilih Hingga Mayor Berikutnya dan ambil opsi default.
  4. Pilih modul yang Anda butuhkan di kolom Produk Paket .

Sekarang setelah Anda mengintegrasikan kerangka kerja dalam aplikasi Anda, saatnya untuk memulai SDK dan menggunakan layanan App Center.

Nota

Jika Anda mengintegrasikan App Center melalui SwiftPM dan ingin menggunakannya di target ekstensi aplikasi Anda juga, pastikan Anda menyediakan DISABLE_DIAMOND_PROBLEM_DIAGNOSTIC=YES dalam konfigurasi Anda. Ini diperlukan untuk menghindari keterbatasan SwiftPM dalam menautkan modul ke beberapa target.

3.4 Integrasi dengan menyalin biner ke dalam proyek Anda

Di bawah ini adalah langkah-langkah tentang cara mengintegrasikan biner yang dikompilasi dalam proyek Xcode Anda untuk menyiapkan App Center Crash untuk ekstensi aplikasi Anda.

Nota

App Center SDK mendukung penggunaan XCframework. Jika Anda ingin mengintegrasikan XCframeworks ke dalam proyek Anda, unduh AppCenter-SDK-Apple-XCFramework.zip dari halaman rilis dan unzip. Konten folder yang dihasilkan tidak spesifik platform, sebaliknya berisi XCframeworks untuk setiap modul. Mereka dapat diintegrasikan dengan cara yang sama seperti kerangka kerja biasa, seperti yang dijelaskan di bawah ini.

  1. Unduh kerangka kerja App Center SDK yang disediakan sebagai file zip.

  2. Buka zip file dan Anda akan melihat folder bernama AppCenter-SDK-Apple yang berisi kerangka kerja yang berbeda untuk setiap layanan App Center di setiap folder platform. Kerangka kerja yang disebut AppCenter diperlukan dalam proyek karena berisi kode yang dibagikan antara modul yang berbeda.

  3. [Opsional] Buat subdirektori untuk pustaka pihak ketiga.

    • Sebagai praktik terbaik, pustaka pihak ketiga biasanya berada dalam subdirektori, sering disebut Vendor. Jika proyek tidak diatur dengan subdirektori untuk pustaka, buat subdirektori Vendor sekarang.
    • Buat grup bernama Vendor di dalam proyek Xcode Anda untuk meniru struktur file Anda pada disk.

  4. Buka folder AppCenter-SDK-Apple yang tidak di-zip di Finder dan salin folder ke folder proyek Anda di lokasi tempat Anda menginginkannya. Folder berisi kerangka kerja dalam subfolder untuk platform lain yang didukung App Center SDK, sehingga Anda mungkin perlu menghapus subfolder yang tidak Anda butuhkan.

  5. Tambahkan kerangka kerja SDK ke proyek di Xcode:

    • Pastikan Navigator Proyek terlihat (⌘+1).
    • Sekarang drag dan drop AppCenter.framework dan AppCenterCrashes.framework dari Finder (di lokasi dari langkah sebelumnya) ke Project Navigator Xcode. AppCenter.framework diperlukan untuk memulai SDK. Jika tidak ditambahkan ke proyek, modul lain tidak akan berfungsi dan ekstensi aplikasi Anda tidak akan dikompilasi.
    • Kotak dialog akan muncul, pastikan target ekstensi aplikasi Anda dicentang. Lalu klik Selesai.

Setelah Anda mengintegrasikan kerangka kerja di ekstensi aplikasi, saatnya untuk memulai SDK dan menggunakan layanan App Center.

4. Mulai SDK

Untuk menggunakan App Center, Anda harus ikut serta dalam modul yang akan digunakan. Secara default, tidak ada modul yang dimulai, dan Anda harus secara eksplisit memanggil masing-masing modul saat memulai SDK.

4.1 Menambahkan pernyataan impor

Sisipkan baris berikut dalam file yang berisi titik masuk ekstensi aplikasi. Misalnya, di dalam file ViewController utama ekstensi Today.

@import AppCenter;
@import AppCenterCrashes;

import AppCenter
import AppCenterCrashes

4.2 Tambahkan start:withServices: metode

Sisipkan baris berikut di titik masuk ekstensi aplikasi. Misalnya, dalam metode viewDidLoad pada file utama ViewController dari ekstensi Today.

[MSACAppCenter start:@"{Your App Secret}" withServices:@[[MSACCrashes class]]];

AppCenter.start(withAppSecret: "{Your App Secret}", services: [Crashes.self])

Saat ini, hanya pelaporan crash yang didukung untuk ekstensi aplikasi.

4.3 Ganti variabel dengan rahasia aplikasi Anda

Pastikan untuk mengganti {Your App Secret} teks dengan nilai aktual untuk ekstensi aplikasi Anda. Rahasia Aplikasi dapat ditemukan di halaman Memulai atau halaman Pengaturan di portal App Center.

Halaman Memulai berisi sampel kode di atas dengan Rahasia Aplikasi Anda di dalamnya, Anda dapat menyalin-tempel seluruh sampel.

Bagus, Anda sudah siap untuk memvisualisasikan data Kecelakaan di portal yang dikumpulkan oleh SDK secara otomatis.

Lihat dokumentasi untuk App Center Crash untuk mempelajari cara menyesuaikan ekstensi aplikasi Anda dan menggunakan fungsionalitas yang lebih canggih.