Menguji beberapa pengguna

Halaman ini menjelaskan aspek penting pengujian beberapa pengguna di platform Android. Untuk mengetahui informasi tentang cara menerapkan dukungan multi-pengguna, lihat Mendukung beberapa pengguna.

Jalur perangkat

Tabel berikut mencantumkan beberapa jalur perangkat dan cara penyelesaiannya. Semua nilai di kolom Jalur adalah penyimpanan sandbox khusus pengguna. Alur penyimpanan Android telah berubah dari waktu ke waktu; baca dokumentasi Penyimpanan untuk mengetahui informasi selengkapnya.

Berikut contoh penggunaan jalur khusus pengguna:

# to access user 10's private application data for app com.bar.foo:
$ adb shell ls /data/user/10/com.bar.foo/

Interaksi adb antar-pengguna

Beberapa perintah adb berguna saat menangani beberapa pengguna. Beberapa perintah ini hanya didukung di Android 9 dan yang lebih tinggi:

• adb shell am instrument --user <userId> menjalankan uji instrumentasi terhadap pengguna tertentu. Secara default, perintah ini menggunakan pengguna saat ini.
• adb install --user <userId> menginstal paket untuk pengguna tertentu. Untuk memastikan paket diinstal untuk semua pengguna, Anda harus memanggilnya untuk setiap pengguna.
• adb uninstall --user <userId> meng-uninstal paket untuk pengguna tertentu. Panggil tanpa tanda --user untuk meng-uninstal bagi semua pengguna.
• adb shell am get-current-user mendapatkan ID pengguna saat ini (latar depan).
• adb shell pm list users mendapatkan daftar semua pengguna yang ada.
• adb shell pm create-user membuat pengguna baru, dan menampilkan ID.
• adb shell pm remove-user menghapus pengguna tertentu berdasarkan ID.
• adb shell pm disable --user <userId> menonaktifkan paket untuk pengguna tertentu.
• adb shell pm enable --user <userId> mengaktifkan paket untuk pengguna tertentu.
• adb shell pm list packages --user <userId> mencantumkan paket (-e untuk diaktifkan, -d untuk dinonaktifkan) untuk pengguna tertentu. Secara default, perintah ini selalu mencantumkan untuk pengguna sistem.

Informasi berikut membantu menjelaskan perilaku adb dengan beberapa pengguna:

• adb (atau lebih tepatnya daemon adbd) selalu berjalan sebagai pengguna sistem (ID pengguna = 0) terlepas dari pengguna mana yang saat ini aktif. Oleh karena itu, jalur perangkat yang bergantung pada pengguna (seperti /sdcard/) selalu diselesaikan sebagai pengguna sistem. Lihat Jalur perangkat untuk mengetahui detail selengkapnya.

• Jika pengguna default tidak ditentukan, setiap subperintah adb akan memiliki pengguna yang berbeda. Praktik terbaiknya adalah mengambil ID pengguna dengan am get-current-user lalu menggunakan --user <userId> secara eksplisit untuk perintah apa pun yang mendukungnya. Tanda pengguna eksplisit tidak didukung untuk semua perintah hingga Android 9.

• Akses ke jalur /sdcard pengguna sekunder ditolak mulai Android 9. Lihat Penyedia konten untuk data multi-pengguna guna mengetahui detail tentang cara mengambil file selama pengujian.

Penyedia konten untuk data multi-pengguna

Karena adb berjalan sebagai pengguna sistem dan data di-sandbox di Android 9 dan yang lebih tinggi, Anda harus menggunakan penyedia konten untuk mengirim atau mengambil data pengujian dari pengguna non-sistem. Hal ini tidak diperlukan jika:

• adbd berjalan sebagai root (melalui adb root), yang hanya dapat dilakukan menggunakan build userdebug atau usereng.

• Anda menggunakan Trade Federation (Tradefed) ITestDevice untuk mengirim atau mengambil file. Dalam hal ini, gunakan jalur /sdcard/ dalam konfigurasi pengujian Anda (misalnya, lihat kode sumber untuk pushFile di NativeDevice.java).

Saat penyedia konten berjalan di pengguna sekunder, Anda dapat mengaksesnya menggunakan perintah adb shell content dengan user, uri, dan parameter lain yang sesuai.

Solusi sementara untuk developer aplikasi

Berinteraksi dengan file pengujian menggunakan adb content dan instance ContentProvider, bukan perintah push atau pull.

1. Buat instance ContentProvider yang dihosting oleh aplikasi yang dapat menayangkan dan menyimpan file jika diperlukan. Gunakan penyimpanan internal aplikasi.
2. Gunakan perintah adb shell content read atau write untuk mengirim atau mengambil file.

Solusi sementara untuk file media

Untuk mengirim file media ke partisi media kartu SD, gunakan MediaStore publik API. Contoh:

# push MVIMG_20190129_142956.jpg to /storage/emulated/10/Pictures
# step 1
$ adb shell content insert --user 10 --uri content://media/external/images/media/ --bind _display_name:s:foo.jpg

# step 2
$ adb shell content query --user 10 --projection _id --uri content://media/external/images/media/ --where "_display_name=\'foo.jpg\'"

# step 3
$ adb shell content write --user 10 --uri content://media/external/images/media/8022 < MVIMG_20190129_142956.jpg

Menginstal penyedia konten generik

Instal dan gunakan penyedia konten yang ada yang membaca dan menulis file ke jalur /sdcard khusus pengguna.

Buat TradefedContentProvider.apk dari sumber menggunakan make TradefedContentProvider:

```
# install content provider apk
$ adb install --user 10 -g TradefedContentProvider.apk

# pull some_file.txt
$ adb shell content read --user 10 --uri content://android.tradefed.contentprovider/sdcard/some_file.txt > local_file.txt

# push local_file.txt
$ adb shell content write --user 10 --uri content://android.tradefed.contentprovider/sdcard/some_file.txt < local_file.txt
```

Dukungan multi-pengguna Trade Federation

Tradefed adalah test harness Android resmi. Bagian ini merangkum beberapa dukungan bawaan Tradefed untuk skenario pengujian multi-pengguna.

Pemeriksa status

Pemeriksa status sistem (SSC) dijalankan sebelum penyiapan target, dan pembersihannya dijalankan setelah penyiapan tersebut.

UserChecker ditentukan secara eksplisit untuk membantu developer saat menguji beberapa pengguna. Fitur ini melacak apakah pengujian telah mengubah status pengguna di perangkat (misalnya, membuat pengguna tanpa menghapusnya dalam penghancuran). Selain itu, jika user-cleanup ditetapkan, fitur ini akan otomatis mencoba membersihkan setelah pengujian, sekaligus memberikan error yang bermanfaat sehingga pengujian dapat diperbaiki.

<system_checker class="com.android.tradefed.suite.checker.UserChecker" >
    <option name="user-cleanup" value="true" />
</system_checker>

Penyiapan target

Penyiapan target biasanya digunakan untuk menyiapkan perangkat dengan konfigurasi tertentu. Dalam kasus pengujian multi-pengguna, penyiapan dapat digunakan untuk membuat pengguna dari jenis tertentu serta beralih ke pengguna lain.

Untuk jenis perangkat yang tidak memiliki pengguna sekunder, Anda dapat menggunakan CreateUserPreparer untuk membuat dan beralih ke pengguna sekunder di AndroidTest.xml. Di akhir pengujian, penyiapan akan beralih kembali dan menghapus pengguna sekunder.

<target_preparer
  class="com.google.android.tradefed.targetprep.CreateUserPreparer" >
</target_preparer>

Jika jenis pengguna yang Anda inginkan sudah ada di perangkat, gunakan SwitchUserTargetPreparer untuk beralih ke pengguna yang ada. Nilai umum untuk user-type mencakup system atau secondary.

<target_preparer
  class="com.android.tradefed.targetprep.SwitchUserTargetPreparer">
    <option name="user-type" value="secondary" />
</target_preparer>

Pengujian yang didorong host

Dalam beberapa kasus, pengujian perlu beralih pengguna dalam pengujian. Jangan beralih dari dalam framework pengujian sisi perangkat, seperti UI Automator, karena proses pengujian dapat dihentikan kapan saja. Sebagai gantinya, gunakan framework pengujian sisi host seperti framework pengujian yang didorong hostTradefed, yang memberikan akses ke ITestDevice, sehingga memungkinkan manipulasi pengguna yang diperlukan.

Gunakan UserChecker (dijelaskan di Pemeriksa status) untuk pengujian yang didorong host yang mengubah status pengguna karena memastikan pengujian membersihkan dirinya sendiri dengan benar.