Share via

API macOS lainnya

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

Menyesuaikan tingkat log

Anda dapat mengontrol jumlah pesan log yang muncul dari App Center di konsol. setLogLevel:Gunakan -API untuk mengaktifkan pengelogan tambahan saat men-debug. Secara default, ini diatur ke untuk LogLevelAssert lingkungan App Store dan LogLevelWarning sebaliknya.

Untuk memiliki pesan log sebanyak mungkin, gunakan MSACLogLevelVerbose/LogLevel.verbose.

[MSACAppCenter setLogLevel:MSACLogLevelVerbose];

AppCenter.logLevel = .verbose

Mengidentifikasi penginstalan

App Center SDK membuat UUID untuk setiap perangkat setelah aplikasi diinstal. Pengidentifikasi ini tetap sama untuk perangkat saat aplikasi diperbarui dan yang baru dibuat hanya saat aplikasi diinstal ulang. API berikut berguna untuk tujuan penelusuran kesalahan.

NSUUID *installId = [MSACAppCenter  installId];

var installId = AppCenter.installId

Mengidentifikasi pengguna

App Center SDK mendukung pengaturan ID pengguna yang digunakan untuk menambah laporan crash. Untuk menggunakan kapabilitas ini:

  1. Konfigurasikan App Center SDK dengan memanggil :start:withServices: seperti yang dijelaskan dalam panduan Memulai App Center SDK.
  2. Atur userID di SDK menggunakan kode berikut:
[MSACAppCenter setUserId:@"your-user-id"];

AppCenter.userId = "your-user-id"

Setelah mengatur ID pengguna, Anda dapat menggunakan fitur pencarian App Center untuk mencari laporan crash tertentu untuk ID tersebut. Pelajari selengkapnya di dokumentasi pencarian App Center.

Catatan

Nilai untuk ID pengguna dibatasi hingga 256 karakter. Ini akan ditampilkan dengan laporan crash Anda tetapi tidak digunakan untuk agregasi atau jumlah pengguna yang terpengaruh. Jika Anda mengatur ID pengguna beberapa kali, hanya ID pengguna terakhir yang akan digunakan. Anda perlu mengatur ID pengguna sendiri sebelum setiap peluncuran aplikasi, karena nilai ini tidak disimpan oleh SDK di antara peluncuran.

Menonaktifkan semua layanan saat runtime

Jika Anda ingin menonaktifkan semua layanan App Center sekaligus, gunakan setEnabled API. Saat dinonaktifkan, SDK tidak akan meneruskan informasi apa pun ke App Center.

[MSACAppCenter setEnabled:NO];

AppCenter.enabled = false

Untuk mengaktifkan semua layanan sekaligus, gunakan API yang sama tetapi lewati YES/true sebagai parameter.

[MSACAppCenter setEnabled:YES];

AppCenter.enabled = true

Status ini bertahan di penyimpanan perangkat di seluruh peluncuran aplikasi.

Catatan

Metode ini hanya boleh digunakan setelah AppCenter dimulai.

Melarang permintaan jaringan

Di App Center SDK, permintaan jaringan diizinkan secara default. Jika Anda ingin mengirim data yang dikumpulkan oleh App Center SDK oleh masalah pengguna, Anda dapat melarang pengiriman data otomatis.

[MSACAppCenter setNetworkRequestsAllowed:false];

AppCenter.networkRequestsAllowed = false

Dalam hal ini, App Center SDK terus mengumpulkan data tetapi hanya akan dikirim ketika permintaan jaringan akan diizinkan.

[MSACAppCenter setNetworkRequestsAllowed:true];

AppCenter.networkRequestsAllowed = true

Catatan

Nilai ini dipertahankan di antara awal.

Kapan saja, Anda dapat memeriksa apakah mengirim data di App Center SDK diizinkan atau tidak.

[MSACAppCenter isNetworkRequestsAllowed];

AppCenter.networkRequestsAllowed

Mengubah status layanan dalam runtime

Aktifkan atau nonaktifkan layanan pada runtime dengan kode berikut:

[MSACAnalytics setEnabled:NO];

Analytics.enabled = false

Catatan

Metode ini hanya boleh digunakan setelah Analytics dimulai.

Periksa apakah App Center diaktifkan

Anda juga dapat memeriksa apakah App Center diaktifkan atau tidak.

[MSACAppCenter isEnabled];

AppCenter.enabled

Catatan

Metode ini hanya boleh digunakan setelah AppCenter dimulai, metode ini akan selalu kembali false sebelum dimulai.

Periksa versi SDK App Center saat runtime

Anda bisa mendapatkan versi App Center SDK yang saat ini Anda gunakan.

[MSACAppCenter sdkVersion];

AppCenter.sdkVersion

Ukuran penyimpanan

Saat menggunakan App Center SDK, log disimpan secara lokal di perangkat. Log besar dapat memakan banyak ruang, sehingga Anda dapat memilih untuk membatasi ukuran database lokal. Ini juga berguna bersama dengan pause API dan resume . Jika Anda berharap untuk dijeda untuk waktu yang lama, Anda dapat menggunakan ukuran database yang lebih besar untuk menyimpan lebih banyak peristiwa.

setMaxStorageSize Gunakan API untuk mengatur ukuran DB lokal. API bersifat asinkron, dan completionHandler dipanggil saat Anda memulai layanan App Center. Untuk alasan ini, setMaxStorageSize harus dipanggil sebelum panggilan Anda ke AppCenter.start. Anda hanya dapat memanggil API sekali.

// Use 20 MB for storage.
[MSACAppCenter setMaxStorageSize:(20 * 1024 * 1024) completionHandler:^(BOOL success) {
    if (!success) {
        // The success parameter is false when the size can't be honored.
    }
}];
[MSACAppCenter start:@"{Your App Secret}", withServices:@[[MSACAnalytics class]]];

// Use 20 MB for storage.
AppCenter.setMaxStorageSize(20 * 1024 * 1024, completionHandler: { (success) in
    if !success {
        // The success parameter is false when the size can't be honored.
    }
})
AppCenter.start(withAppSecret: "{Your App Secret}", services:[Analytics.self])

Jika Anda tidak mengatur ukuran penyimpanan maksimum, SDK menggunakan ukuran maksimum default 10 MB. Ukuran minimum yang diizinkan untuk Anda tetapkan adalah 20 KB.

Catatan

Ukuran penyimpanan maks aktual mungkin sedikit lebih tinggi dari nilai yang Anda pilih. SQLite membulatkan ukuran hingga ke kelipatan ukuran halaman berikutnya. App Center SDK menggunakan ukuran halaman 4 KB.

Catatan

Log yang lebih lama dari 25 hari akan dibuang.

Panggilan API yang gagal

Ada banyak alasan completionHandler panggilan dapat mengembalikan false.

  • Ukuran yang ditentukan adalah nilai yang tidak valid (kurang dari 20 KB atau lebih besar dari 140 TB).
  • Ukuran database saat ini lebih besar dari ukuran maksimum yang ditentukan.
  • API telah dipanggil. Anda dapat mengonfigurasinya hanya sekali per proses.
  • API telah dipanggil setelah AppCenter.start atau AppCenter.configure.

Anda dapat memeriksa peringatan dan kesalahan di konsol menggunakan AppCenter tag log untuk memecahkan masalah konfigurasi.