Mulai menggunakan iOS

  • Artikel

Penting

Visual Studio App Center dijadwalkan untuk dihentikan pada 31 Maret 2025. Meskipun Anda dapat terus menggunakan Visual Studio App Center hingga sepenuhnya dihentikan, ada beberapa alternatif yang direkomendasikan yang dapat Anda pertimbangkan untuk bermigrasi.

Pelajari selengkapnya tentang garis waktu dukungan dan alternatif.

App Center SDK menggunakan arsitektur modular sehingga Anda dapat menggunakan salah satu atau semua layanan.

Anda dapat menemukan informasi tentang data yang dikumpulkan oleh App Center pada Data yang Dikumpulkan oleh App Center SDK, Peraturan Perlindungan Data Umum, dan halaman FAQ . Selain itu, FAQ berisi jawaban, yang perlu Anda berikan untuk konfigurasi privasi App Store.

Mari kita mulai menyiapkan App Center iOS SDK di aplikasi Anda untuk menggunakan App Center Analytics dan App Center Crash. Untuk menambahkan Distribusi App Center ke aplikasi Anda, lihat dokumentasi untuk Distribusi App Center.

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 Crash (hanya untuk Crash App Center).
  • Jika Anda menggunakan CocoaPods untuk mengintegrasikan App Center, Anda memerlukan CocoaPods versi 1.10 atau yang lebih baru.

Analitik dan Crash App Center SDK kompatibel dengan Mac Catalyst melalui XCFramework atau SwiftPM.

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

Jika 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.

3. Tambahkan modul App Center SDK

App Center SDK untuk iOS dapat ditambahkan ke aplikasi Anda melalui Cocoapods, Carthage, Swift Package Manager, atau dengan menambahkan biner secara manual ke proyek Anda.

Catatan

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

3.1 Integrasi melalui Cocoapods

Catatan

Simulator ARM64 (saat diluncurkan dari Xcode yang berjalan di Apple Silicon Mac) tidak didukung melalui CocoaPods, pertimbangkan untuk menggunakan metode integrasi lain agar berfungsi.

  1. Tambahkan dependensi berikut ke Anda podfile untuk menyertakan App Center Analytics dan App Center Crash ke aplikasi Anda. Tindakan ini menarik kerangka kerja berikut: AppCenter, AppCenterAnalytics, dan AppCenterCrashes. Sebagai gantinya, Anda dapat menentukan layanan yang Anda inginkan di aplikasi Anda. Setiap layanan memiliki subspec sendiri dan semuanya bergantung pada AppCenter. Ini akan ditarik secara otomatis.

     # Use the following line to use App Center Analytics and Crashes.x
 pod 'AppCenter'

 # Use the following lines if you want to specify which service you want to use.
 pod 'AppCenter/Analytics'
 pod 'AppCenter/Crashes'
 pod 'AppCenter/Distribute'

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

Catatan

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 memanfaatkan 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.

Catatan

Integrasi Carthage tidak berfungsi secara langsung di Xcode 12. Untuk membuatnya berfungsi, lihat instruksi Carthage ini

  1. Tambahkan dependensi berikut ke Anda Cartfile untuk menyertakan App Center. Dependensi ini menarik semua kerangka kerja. Kemudian Anda hanya dapat menautkan kerangka kerja yang ingin Anda gunakan 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 untuk mengambil dependensi ke dalam folder Carthage/Checkouts . Kemudian buat setiap kerangka kerja.

  3. Buka tab Pengaturan umum target aplikasi Anda. Seret dan letakkan file AppCenter.framework, AppCenterAnalytics.framework, dan AppCenterCrashes.framework dari folder Carthage/Build/iOS 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. Dialog akan muncul, pastikan target aplikasi Anda dicentang. Lalu klik Selesai.

    Catatan

    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 memanfaatkan layanan App Center.

3.3 Integrasi melalui Swift Package Manager

  1. Dari menu Xcode klik File > Swift Packages > Add Package Dependency.
  2. Dalam dialog yang muncul, masukkan URL repositori: https://github.com/microsoft/appcenter-sdk-apple.git.
  3. Di Versi, pilih Naik ke Utama 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 memanfaatkan layanan App Center.

Catatan

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 Analytics dan App Center Crash untuk aplikasi iOS Anda.

Catatan

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 untuk 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, yang 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 di disk.

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

  5. Tambahkan kerangka kerja SDK ke proyek di Xcode:

    • Pastikan Navigator Proyek terlihat (⌘+1).
    • Sekarang seret & jatuhkan AppCenter.framework, AppCenterAnalytics.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 aplikasi Anda tidak akan dikompilasi.
    • Dialog akan muncul, pastikan target aplikasi Anda dicentang. Lalu klik Selesai.

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

4. Mulai SDK

Untuk menggunakan App Center, pilih modul yang ingin Anda gunakan. Secara default, tidak ada modul yang dimulai dan Anda harus memanggil masing-masing modul saat memulai SDK.

Instruksi di bawah ini sedikit berbeda tergantung pada siklus hidup apa yang Anda gunakan. Mulai dari Xcode 12 Anda dapat memilih salah satu dari dua siklus hidup: "Swift UI App" (dipilih secara default di Xcode 12) dan "UI Kit AppDelegate". Jika Anda mengembangkan ekstensi, lihat halaman Memulai ekstensi.

4.1 Menambahkan pernyataan impor

Buka file AppDelegate proyek (untuk siklus hidup AppDelegate UI Kit) atau <file ProjectName>App.swift (untuk siklus hidup Aplikasi Swift UI) dan tambahkan pernyataan impor berikut:

@import AppCenter;
@import AppCenterAnalytics;
@import AppCenterCrashes;

import AppCenter
import AppCenterAnalytics
import AppCenterCrashes

4.2 Menambahkan start:withServices: metode

UI Kit AppDelegate

Tambahkan kode inisialisasi ke metode didFinishLaunchingWithOptions delegasi:

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

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

Siklus hidup Aplikasi Swift UI

Untuk memastikan App Center SDK berfungsi dengan benar dengan Swift UI, inisialisasi setelah UI dimuat. Cara paling sederhana untuk mencapainya adalah dengan menggunakan UIApplicationDelegate:

class AppDelegate: NSObject, UIApplicationDelegate {
    func application(_ application: UIApplication, didFinishLaunchingWithOptions launchOptions: [UIApplication.LaunchOptionsKey : Any]? = nil) -> Bool {
          AppCenter.start(withAppSecret: "{Your App Secret}", services:[
            Crashes.self, Analytics.self, Distribute.self])
        return true
    }
}

Kemudian gunakan UIApplicationDelegateAdaptor dalam struct:

@main
struct YourAppName: App {

  @UIApplicationDelegateAdaptor(AppDelegate.self) var appDelegate

    var body: some Scene {
        WindowGroup {
            ContentView()
        }
    }
}

Jika Anda memiliki aplikasi Catalyst, Anda dapat meneruskan rahasia aplikasi untuk iOS dan macOS secara bersamaan:

AppCenter.start(withAppSecret:"ios={Your iOS App Secret};macos={Your macOS App Secret}", services: [Analytics.self, Crashes.self])

Peringatan

Tidak disarankan untuk menyematkan Rahasia Aplikasi Anda dalam kode sumber.

Jika Anda perlu memulai layanan App Center secara terpisah, Anda harus:

  1. Konfigurasikan atau mulai dengan Rahasia Aplikasi.
  2. Jika kode dapat dipanggil beberapa kali, periksa apakah App Center sudah dikonfigurasi.
  3. Mulai layanan yang diperlukan tanpa Rahasia Aplikasi.
[MSACAppCenter configureWithAppSecret:@"{Your App Secret}"];
if ([MSACAppCenter isConfigured]) {
   [MSACAppCenter startService:[MSACAnalytics class]];
   [MSACAppCenter startService:[MSACCrashes class]];
}

AppCenter.configure(withAppSecret: "{Your App Secret}")
if AppCenter.isConfigured {
    AppCenter.startService(Analytics.self)
    AppCenter.startService(Crashes.self)
}

4.3 Ganti tempat penampung dengan Rahasia Aplikasi Anda

Pastikan untuk mengganti {Your App Secret} teks dengan nilai aktual untuk 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.

Contoh di atas menunjukkan cara menggunakan start:withServices metode (start(withAppSecret:services:) untuk Swift) dan menyertakan App Center Analytics dan App Center Crash.

Jika Anda tidak ingin menggunakan salah satu dari dua layanan, hapus parameter yang sesuai dari panggilan metode di atas.

Kecuali Anda secara eksplisit menentukan setiap modul sebagai parameter dalam metode mulai, Anda tidak dapat menggunakan layanan App Center tersebut. Selain itu start:withServices , API (start(withAppSecret:services:) untuk Swift) hanya dapat digunakan sekali dalam siklus hidup aplikasi Anda - semua panggilan lain akan mencatat peringatan ke konsol dan hanya modul yang disertakan dalam panggilan pertama yang akan tersedia.

Misalnya - Jika Anda ingin onboarding ke App Center Analytics, Anda harus memodifikasi start:withServices panggilan API (start(withAppSecret:services:) untuk Swift) sebagai berikut:

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

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

Hebat, Anda sudah siap untuk memvisualisasikan data Analytics dan Crash di portal yang dikumpulkan SDK secara otomatis.

Lihat dokumen App Center Analytics dan dokumen App Center Crash untuk mempelajari cara menyesuaikan dan menggunakan fungsionalitas yang lebih canggih dari kedua layanan.

Untuk mempelajari cara memulai pembaruan dalam aplikasi, baca dokumentasi Distribusi App Center.