Gunakan laporan prapelancaran untuk mengenal pasti masalah

Artikel ini menerangkan cara menyediakan dan menjalankan laporan prapelancaran. Jika anda telah menjalankan laporan prapelancaran dan ingin mengetahui cara mentafsir keputusan, pergi ke Fahami laporan prapelancaran anda.

Laporan prapelancaran akan dijana secara automatik apabila anda menerbitkan apl ke ujian dalaman, tertutup atau terbuka. Laporan ini membantu untuk mengenal pasti masalah secara proaktif sebelum apl anda menjangkau pengguna. Laporan ini merangkumi ujian untuk:

• Isu kestabilan
• Isu keserasian Android
• Isu prestasi
• Isu kebolehaksesan
• Kerentanan keselamatan
• Masalah privasi

Cara laporan prapelancaran berfungsi

Selepas anda memuat naik dan menerbitkan Android App Bundle ujian, kami memasang item tersebut pada satu set peranti Android dalam makmal ujian kami. Kemudian kami akan melancarkan apl anda dan membuat rangkakan secara automatik selama beberapa minit. Perangkak akan melakukan tindakan asas seperti menaip, mengetik dan meleret. Anda juga boleh menyediakan ujian tersuai atau menguji bukti kelayakan akaun untuk digunakan oleh perangkak.

Selepas rangkakan selesai, kami akan mengumpulkan keputusan anda dalam laporan prapelancaran. Kami juga akan menyahpasang apl anda daripada semua peranti.

Menilai kesesuaian apl anda untuk laporan prapelancaran

Laporan prapelancaran akan berfungsi selagi kami dapat memasang apl dan membuat "rangkak" pada apl anda. Walau bagaimanapun, apl tertentu mungkin memerlukan sedikit pengubahsuaian kod. Contoh biasa termasuk apl yang memerlukan pengesahan negara atau pengesahan pemasangan. Untuk mengetahui lebih lanjut, lawati soalan lazim kami.

Harap maklum bahawa peranti ujian tidak dapat menjalankan ujian terhadap apl yang tiada aktiviti pelancaran utama termasuk pelancar, widget, papan kekunci dan muka jam.

Runtuhkan Semua Kembangkan Semua

Jalankan laporan prapelancaran

Uji apl anda

Untuk menjana laporan prapelancaran apl anda, terbitkan apl anda pada runut ujian terbuka atau tertutup.

Anda akan menerima laporan prapelancaran secara automatik untuk mana-mana apl yang anda terbitkan pada runut ujian melainkan anda menarik diri. Biasanya anda akan menerima hasil ujian dalam tempoh sejam selepas memuat naik app bundle anda. Dalam sesetengah keadaan, anda akan menerima hasil ujian beberapa jam selepas memuat naik.

Daftar untuk menerima e-mel laporan prapelancaran

Anda boleh menerima pemberitahuan e-mel untuk laporan prapelancaran yang tersedia dengan mengikut langkah ini:

1. Buka Play Console > Pemberitahuan.
2. Tatal ke bawah pada "Laporan prapelancaran" dan tanda semak kotak di sebelah laporan ini. Anda boleh memilih untuk menerima e-mel bagi semua ujian atau ujian yang mengandungi isu sahaja.

Matikan laporan prapelancaran

Laporan prapelancaran dijana secara automatik apabila anda menerbitkan apl pada runut ujian tertutup atau terbuka. Untuk melumpuhkan semua laporan prapelancaran apl anda:

1. Buka Play Console> Laporan prapelancaran > Tetapan.
2. Tatal ke bawah pada "Pilihan" dan nyahtanda kotak "Hidupkan laporan prapelancaran" untuk melumpuhkan laporan apl anda.
3. Klik Simpan.

Sesuaikan ujian anda

Anda boleh menyesuaikan ujian anda untuk menjadikan laporan prapelancaran anda lebih menyeluruh dan berkaitan dengan apl anda.

Langkah 1: Berikan bukti kelayakan akaun ujian jika apl anda mengandungi skrin log masuk

Jika apl anda mengandungi skrin log masuk dan anda mahu perangkak menguji proses log masuk atau kandungan di sebalik log masuk itu, anda perlu memberikan bukti kelayakan akaun.

Nota: Anda tidak perlu memberikan bukti kelayakan jika apl anda menyokong "Log masuk dengan Google", (yang membolehkan perangkak log masuk secara automatik) atau jika anda telah memberikan bukti kelayakan pada Halaman kandungan apl.

Berikut ialah beberapa perkara yang perlu anda ingat semasa menguji bukti kelayakan:

• Bukti kelayakan yang anda berikan akan digunakan untuk tujuan ujian sahaja.
• Walaupun kami berusaha sedaya upaya untuk memastikan keselamatan bukti kelayakan ujian, kami menyarankan agar anda tidak menambahkan sebarang bukti kelayakan rasmi dalam laporan prapelancaran. Sebaliknya, buat nama pengguna dan kata laluan akaun ujian.
• Bukti kelayakan hanya boleh dimasukkan secara automatik ke dalam apl Android yang menggunakan widget Android standard. Bukti kelayakan tidak boleh digunakan dalam apl yang menggunakan OpenGL untuk memaparkan kawalan tersuai atau apl yang menggunakan Paparan Web untuk aliran pengesahan berasaskan web.
• Google akan log masuk secara automatik jika apl anda menyokong "Log masuk dengan Google".

Sediakan bukti kelayakan

1. Buka Play Console.
2. Pilih satu apl.
3. Pada menu sebelah kiri, pilih Ujian > Laporan prapelancaran > Tetapan.
4. Dalam bahagian “Bukti kelayakan akaun ujian”, pilih Berikan bukti kelayakan.
5. Masukkan yang berikut:
   • Nama pengguna: Nama pengguna yang dikaitkan dengan akaun ujian anda.
   • Kata Laluan: Kata laluan yang dikaitkan dengan akaun ujian anda.
6. Klik Simpan. Bukti kelayakan ini akan digunakan untuk semua ujian masa hadapan melainkan maklumat ini diedit.

Edit atau alih keluar bukti kelayakan

1. Buka Play Console.
2. Pilih satu apl.
3. Pada menu sebelah kiri, pilih Ujian > Laporan prapelancaran > Tetapan.
4. Buat perubahan anda:
   • Untuk mengedit bukti kelayakan: Dalam bahagian “Uji bukti kelayakan akaun”, masukkan bukti kelayakan anda yang dikemas kini dalam medan nama pengguna dan kata laluan.
   • Untuk mengalih keluar bukti kelayakan: Dalam bahagian “Uji bukti kelayakan akaun”, pilih Jangan berikan bukti kelayakan.
     • Nota: Jika anda mengalih keluar bukti kelayakan ujian apl, anda perlu menambah bukti kelayakan baharu sebelum sebarang ujian masa hadapan boleh log masuk ke apl anda.
5. Klik Simpan. Bukti kelayakan ini akan digunakan untuk semua ujian masa hadapan melainkan maklumat ini diedit.

Langkah 2: Sediakan skrip Robo atau gelung permainan

Jika anda mahu mengawal langkah yang diambil oleh perangkak semasa menguji apl anda, anda boleh menyediakan skrip Robo atau gelung permainan.

Sediakan skrip Robo untuk menyesuaikan laluan ujian apl Java

Anda boleh mengawal langkah yang diambil oleh perangkak semasa menguji apl anda dengan menyediakan skrip Robo untuk melakukan tindakan tertentu seperti menguji perjalanan pengguna biasa atau bahagian baharu apl anda.

Apabila anda menjalankan ujian menggunakan skrip yang dilampirkan, perangkak menjalankan tindakan praskrip terlebih dahulu, kemudian meneroka apl seperti biasa.

Untuk memuat naik laporan prapelancaran anda:

1. Rakam skrip anda menggunakan alat Firebase dalam Studio Android (Studio Android > Alatan > Firebase > Makmal Ujian > Rakam Skrip Robo). Untuk mendapatkan butiran, akses Pusat Bantuan Firebase.
   • Nota: Anda tidak memerlukan akaun Firebase untuk membuat skrip Robo.
2. Apabila skrip anda sudah siap, buka Play Console.
3. Pilih satu apl.
4. Pilih Ujian > Laporan prapelancaran > Tetapan. Dalam bahagian "Kawal cara laporan prapelancaran meneroka apl anda", muat naik skrip anda. Anda boleh seret dan lepaskan fail anda atau pilih Muat naik.
5. Klik Simpan.

Sediakan gelung permainan untuk menguji apl atau permainan OpenGL

Jika anda menguji permainan atau apl yang menggunakan OpenGL, anda perlu menyediakan gelung permainan untuk mendapatkan laporan prapelancaran yang baik. Gelung permainan mentakrifkan tindakan yang anda mahu dilakukan oleh perangkak. Anda boleh menguji beberapa gelung permainan dalam apl yang sama.

Untuk menggunakan gelung permainan dalam laporan prapelancaran anda:

1. Ubah suai permainan anda untuk melakukan perkara berikut:
   • Melancarkan gelung
   • Menjalankan gelung
   • Menutup gelung (pilihan). Anda membuat pengubahsuaian ini dalam persekitaran pembangunan anda. Untuk mendapatkan butiran, akses Pusat Bantuan Firebase.
     • Nota: Anda tidak memerlukan akaun Firebase untuk menggunakan gelung permainan dalam laporan prapelancaran.
2. Terbitkan versi permainan anda menggunakan gelung permainan pada runut ujian tertutup atau terbuka. Perangkak akan mengesan dan melaksanakan gelung permainan secara automatik.

Langkah 3: Sesuaikan titik mula ujian dengan pautan dalam

Anda boleh menambahkan maksimum tiga pautan dalam pada laporan prapelancaran anda untuk menguji titik masuk tambahan bagi apl anda.

Perangkak akan berfungsi seperti biasa selama beberapa minit, kemudian menutup apl tersebut dan melawati setiap pautan dalam dan merangkak lagi selama 30 saat. Sebarang isu yang ditemukan sepanjang rangkakan tambahan ini akan disertakan dalam laporan seperti biasa.

Untuk mengetahui cara membuat dan menguji pautan dalam bagi apl anda, lawati laman Pembangun Android.

Langkah 4: Lihat laporan ujian untuk bahasa tertentu

Jika anda mahu melihat keputusan ujian bagi bahasa tertentu, anda boleh menyediakan pilihan bahasa pada halaman Tetapan laporan prapelancaran. Anda boleh memilih maksimum lima bahasa.

Petua: Oleh sebab laporan prapelancaran berjalan secara automatik apabila anda memuat naik app bundle ujian, anda hanya boleh menambahkan pilihan bahasa selepas ujian awal selesai.

Sediakan pilihan bahasa

1. Buka Play Console.
2. Pilih satu apl.
3. Pada menu sebelah kiri, pilih Ujian > Laporan prapelancaran > Tetapan.
4. Pada bahagian "Uji apl anda dalam bahasa tertentu", pilih + Tambah bahasa.
5. Pilih hingga lima bahasa. Untuk ujian masa hadapan, anda hanya akan melihat keputusan ujian daripada bahasa ini.
   • Nota: Jika anda tidak memilih mana-mana bahasa, kami akan memilih bahasa secara automatik, iaitu bahasa yang paling banyak digunakan untuk pemasangan apl anda.
6. Klik Simpan.

Lihat laporan prapelancaran anda

Apabila laporan prapelancaran anda tersedia, anda boleh melihat ringkasan ujian yang merangkumi bilangan ralat, amaran dan masalah kecil yang dijumpai semasa ujian dan dikategorikan berdasarkan jenis isu. Anda juga akan melihat cadangan pelancaran berdasarkan keputusan ujian apl anda.

Lihat ringkasan laporan prapelancaran

Untuk melihat ringkasan laporan prapelancaran anda:

1. Buka Play Console.
2. Pilih satu apl.
3. Pilih Ujian > Laporan prapelancaran > Ikhtisar.
4. Semak setiap bahagian:
   • Kestabilan
   • Prestasi
   • Kebolehaksesan
   • Keselamatan dan kepercayaan
5. Jika mana-mana bahagian mengandungi isu, pilih Tunjukkan ringkasan untuk mengembangkan paparan.
6. Pilih Lihat butiran untuk melihat maklumat yang lebih terperinci untuk isu anda.
7. Untuk melihat laporan prapelancaran terdahulu, tatal pada jadual dalam bahagian “Butiran laporan” pada bahagian bawah halaman.

Nota: Jika anda melihat mesej "Ujian sedang berlangsung", ini bermakna ujian terbaharu anda masih belum selesai. Jika ujian terbaharu anda tidak dapat dijalankan, anda akan melihat mesej "Ujian gagal". Untuk menjalankan ujian lain, terbitkan app bundle lain.

Lihat butiran laporan prapelancaran

Untuk melihat keputusan laporan prapelancaran terperinci anda:

1. Buka Play Console.
2. Pilih satu apl.
3. Pilih Ujian > Laporan prapelancaran > Butiran.
4. Semak tab Kestabilan, Prestasi, Kebolehaksesan, Tangkapan skrin dan Keselamatan dan kepercayaan. Pada setiap halaman, anda akan melihat butiran lengkap keputusan ujian anda yang terkini, termasuk surih tindanan, tangkapan skrin dan carta.

Nota: Jika anda melihat mesej "Ujian sedang berlangsung", ini bermakna ujian terbaharu anda masih belum selesai. Jika ujian terbaharu anda tidak dapat dijalankan, anda akan melihat mesej "Ujian gagal". Untuk menjalankan ujian lain, terbitkan app bundle lain.

Soalan lazim

Runtuhkan Semua Kembangkan Semua

Ujian apl

Berapa lamakah masa yang diambil untuk ujian?

Biasanya anda akan menerima hasil ujian dalam tempoh sejam selepas memuat naik app bundle anda. Dalam sesetengah keadaan, anda akan menerima hasil ujian beberapa jam selepas memuat naik. Jika laporan tidak lengkap selepas dua hari, cuba muat naik artifak anda sekali lagi. Tindakan ini akan mencetuskan laporan baharu.

Apl yang menjalankan pengesahan semasa dilancarkan

Bolehkah saya menjalankan laporan prapelancaran untuk apl yang melaksanakan pengesahan negara?

Anda masih boleh mendapatkan laporan prapelancaran jika anda bersedia untuk membuat pengubahsuaian kecil pada kod anda.

Peranti ujian terletak di Amerika Syarikat. Jika apl anda menggunakan geolokasi atau dikenakan sekatan kandungan berdasarkan negara, peranti ujian dapat menunjukkan perkara yang tersedia di lokasi peranti sahaja.

Jika anda perlu menguji apl anda di geolokasi di luar lokasi peranti ujian, anda boleh menerbitkan app bundle yang mengalih keluar keperluan lokasi untuk tujuan ujian. Terdapat dua cara anda boleh mengesan bahawa laporan prapelancaran anda sedang dijalankan dalam Makmal Ujian:

• Anda boleh menyenaraiputihkan sekatan alamat IP yang didokumenkan dalam Ikhtisar Makmal Ujian Firebase ini.
• Anda boleh menyemak Ubah suai gelagat ujian berinstrumen untuk Makmal Ujian dengan menambahkan pemboleh ubah sistem.

Bolehkah saya mendapatkan laporan prapelancaran untuk apl yang menyemak peranti terpahat?

Platform ujian tidak menyokong apl yang menyemak sama ada peranti mempunyai kawalan istimewa (akses akar) pada Android.

Apl yang mengandungi iklan atau pilihan pembelian

Apl saya mengandungi iklan. Bagaimanakah saya dapat memastikan bahawa ujian laporan prapelancaran tidak menyumbang kepada tera dan klik saya (yang mungkin dikesan atau tidak disenangi oleh rangkaian iklan saya)?

Iklan Google sudah mengecualikan trafik daripada julat alamat laporan prapelancaran. Untuk rangkaian iklan lain, anda perlu menyatakan julat alamat IP yang hendak dikecualikan.

Adakah perkara yang perlu saya ketahui tentang apl ujian yang mengandungi iklan paparan?

Untuk mendapatkan butiran tentang cara mengurangkan hasil iklan palsu dengan ujian apl automatik, semak tapak Google Developers.

Adakah ujian merangkumi pembelian langganan atau produk dlm apl?

Peranti ujian tidak dapat membuat pembelian semasa ujian dijalankan. Jika apl anda menawarkan langganan atau produk dalam apl untuk mengakses sesetengah bahagian apl anda, senario ujian mungkin terhad.

Gelagat apl lain

Kod saya dikaburkan (Java) atau dilucutkan (asli). Adakah saya masih boleh menggunakan laporan prapelancaran?

Ya. Ujian laporan prapelancaran akan tetap berjalan.

Walau bagaimanapun, jika kod anda dikaburkan atau dilucutkan, sebarang keranapan atau ANR yang dijumpai semasa ujian akan mempunyai surih tindanan yang dikaburkan atau dilucutkan juga. Untuk membolehkan kami menjadikan surih tindanan anda lebih mudah untuk dinyahpepijat, kami syorkan anda memuat naik fail penyahkeliruan atau simbolikasi.

Anda boleh mengetahui lebih lanjut tentang memuat naik fail penyahkeliruan atau simbolikasi.

Adakah cara untuk pramuat peranti ujian dengan media atau apl prapasang tambahan?

Tidak. Platform ujian tidak menyokong pramuat peranti dengan media atau apl prapasang.

Walau bagaimanapun, jika anda mahu menjalankan ujian pada apl dengan data yang dipramuat, anda boleh menerbitkan versi ujian apl anda dengan fail media anda yang dibenamkan dalam app bundle.

Bagaimanakah jika apl saya menggunakan perkhidmatan pelesenan Google Play?

Jika apl anda dalam ujian terbuka atau apl anda telah diterbitkan pada saluran pengeluaran, ujian laporan prapelancaran akan menggunakan ID yang bertindak seolah-olah dilesenkan untuk apl anda.

Jika apl anda bukan dalam ujian terbuka dan tidak memiliki app bundle aktif yang diterbitkan pada saluran pengeluaran, apl anda akan gagal semakan pelesenan. Anda masih menerima hasil laporan prapelancaran tetapi apl anda dalam keadaan tidak berlesen. Untuk menjalankan ujian pada apl ini, anda boleh menerbitkan apl anda dalam versi tertutup dengan perkhidmatan pelesenan dilumpuhkan.

Bolehkah peranti ujian menguji apl yang menggunakan konfigurasi landskap?

Peranti ujian telah dipratetap untuk menjalankan ujian pada orientasi halaman potret tetap secara lalai. Walau bagaimanapun, jika apl anda dikunci kepada orientasi landskap, anda akan melihat video dan tangkapan skrin dalam mod landskap.

Pemilihan peranti

Bagaimanakah anda menentukan peranti yang akan digunakan untuk menguji apl saya?

Kami memilih peranti ujian yang menyediakan liputan meluas merentas ekosistem dan mengambil kira populariti peranti, kekerapan ranap sistem, peleraian skrin, pengeluar, versi OS Android dan pelbagai lagi. Pemilihan peranti ujian mungkin berbeza-beza.

Bagaimanakah sekiranya saya mengecualikan sesetengah peranti daripada penyasaran dalam manifes apl saya?

Jika anda telah mengecualikan sesetengah peranti daripada penyasaran dalam manifes apl anda, maka laporan prapelancaran juga akan mengecualikan peranti tersebut dalam ujian tetapi tidak akan menyasarkan sebarang peranti tambahan untuk apl anda.

Bolehkah saya menyesuaikan set peranti ujian?

Laporan prapelancaran dikuasakan oleh Makmal Ujian Firebase. Untuk menyesuaikan peranti yang diuji, pertimbangkan untuk menjalankan ujian anda sendiri dalam konsol Firebase.

Bolehkah saya menjalankan laporan prapelancaran pada apl yang disusun untuk peranti x86?

Boleh, kami akan menjalankan apl pada pelagak dan merangkakkan apl tersebut seperti yang dilakukan pada peranti fizikal.

Apakah faktor bentuk yang boleh saya uji pada apl saya?

Tetapan peranti kami merangkumi telefon, tablet, Wear OS dan peranti Desktop seperti Chromebook. Kami tidak dapat menguji apl secara langsung pada Android Auto atau peranti Android TV.

Bolehkah saya menguji apl saya pada versi lama Android?

Tetapan peranti kami merangkumi peranti Android 9 dan lebih baharu.