Mobile Platform as a Service：Pengelolaan tabel simbol iOS

Tentang tabel simbol

Tabel simbol mencatat hubungan pemetaan antara alamat memori dengan fungsi, nama file, dan nomor baris. Elemen-elemen dalam tabel simbol adalah sebagai berikut:

<alamat awal> <Alamat akhir> <fungsi> [<nama file:nomor baris>]

Ketika sebuah aplikasi iOS crash, tumpukan crash dalam log crash adalah informasi biner yang telah diobfuski. Informasi tumpukan biner dapat diuraikan balik melalui tabel simbol, dan diubah menjadi nama fungsi serta nomor baris yang dapat dibaca, sehingga kode bermasalah dapat dengan mudah ditemukan.

Impor tabel simbol iOS

Sebelum melakukan penguraian balik simbol pada log crash, Anda harus mengunggah tabel simbol terlebih dahulu. Di platform iOS, tabel simbol disimpan dalam file dSYM yang biasanya bernama xxx.app.dSYM. Disarankan untuk mencadangkan file dSYM setiap kali Anda membangun atau merilis sebuah aplikasi.

Ikuti langkah-langkah berikut untuk mengunggah tabel simbol iOS:

1. Di direktori saat ini dari file dSYM, gunakan perintah Linux tar -czvf symbol.tgz ./xxx.app.dSYM untuk menekan file dSYM ke dalam paket tgz.

2. Masuk ke konsol mPaaS, pilih aplikasi target, dan masuk ke halaman Mobile Analysis Service > Analisis Kinerja > Pengelolaan Tabel Simbol iOS dari panel navigasi kiri.

3. Klik Import, masukkan informasi tabel simbol, dan unggah tabel simbol yang sesuai di jendela pop-up Import Tabel Simbol.

   • Versi: Nomor versi aplikasi.

   • Nama Modul: Nama file biner aplikasi iOS, yang disimpan dalam tabel simbol untuk mengidentifikasi file biner aplikasi yang sesuai, sehingga pengguna dapat mencocokkan file biner aplikasi dengan file tabel simbol aplikasi.

     Isi moduleName modul utama aplikasi di sini. Sebagai contoh, jika paketnya adalah Produce.app, maka moduleName-nya adalah Produce.

   • UUID: Pengenal Unik Universal (UUID), pengenal unik yang dihasilkan oleh mesin.

     Aplikasi iOS menghasilkan UUID setiap kali kompilasi terjadi. Untuk memastikan bahwa log dapat berhasil diuraikan balik, UUID dalam tumpukan harus konsisten dengan UUID dalam tabel simbol, yaitu kedua UUID berasal dari kompilasi yang sama. Informasi tumpukan crash hanya dapat diuraikan dan dipulihkan secara akurat ketika UUID dalam tabel simbol yang diimpor konsisten dengan UUID dalam log crash.

     Isi UUID modul utama aplikasi di sini. Jika ada lebih dari satu UUID, Anda dapat menggunakan salah satu dari mereka. Sebagai contoh, jika ada dua arsitektur armv7 dan arm64, maka akan ada dua UUID, dan Anda bisa mengisi salah satu dari mereka. Dalam string UUID, tanda “-“ harus dihapus dan semua karakter harus huruf kecil, misalnya: b7583434dc5e377bb4d8e7b69bf4c1fb.

   • Unggah dari URL: Masukkan URL file tgz yang dikompresi dari tabel simbol. Jika tidak ada file tabel simbol di URL yang ditentukan, pesan kesalahan akan dikembalikan.

4. Klik Import untuk mengimpor tabel simbol.

5. Periksa status impor tabel simbol di halaman pengelolaan tabel simbol iOS. Status Done menunjukkan bahwa tabel simbol telah berhasil diimpor, sedangkan Failed menunjukkan kegagalan impor. Jika impor tabel simbol gagal, Anda dapat mencoba lagi sesuai dengan pesan kesalahan.

Semua tabel simbol yang diimpor ditampilkan di halaman pengelolaan tabel simbol, Anda dapat menanyakannya berdasarkan versi aplikasi.

Tes penguraian

Verifikasi apakah file tabel simbol yang diimpor valid melalui tes penguraian.

Ikuti langkah-langkah berikut untuk melakukan tes penguraian:

1. Dalam daftar tabel simbol iOS, pilih tabel simbol target yang berhasil diimpor, dan klik Tes Penguraian di bawah kolom Operasi.

2. Di kolom Teks Log Mentah, masukkan log crash yang akan diuraikan, dan klik Uraikan Log. Kemudian, kolom Hasil Penguraian Log akan menampilkan teks log yang telah diuraikan. Jika penguraian balik gagal, pesan kesalahan dan alasan kegagalan yang sesuai akan muncul, seperti "Ketidakcocokan UUID".