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 dalam kolom Path adalah penyimpanan sandbox khusus pengguna. Kisah penyimpanan Android telah berubah dari waktu ke waktu; baca dokumentasi Penyimpanan untuk mengetahui informasi selengkapnya.

Berikut adalah 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 berurusan dengan 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, pengguna saat ini akan digunakan.
• 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> menghapus instalasi 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) bagi pengguna tertentu. Secara default, perintah ini selalu mencantumkan pengguna sistem.

Informasi berikut membantu menjelaskan cara kerja adb dengan beberapa pengguna:

• adb (atau lebih akuratnya 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 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. Flag pengguna eksplisit tidak didukung untuk semua perintah hingga Android 9.

• Akses ke jalur /sdcard pengguna sekunder ditolak mulai dari Android 9. Lihat Penyedia konten untuk data multi-pengguna untuk 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 menarik data pengujian dari pengguna non-sistem. Hal ini tidak diperlukan jika:

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

• Anda menggunakan ITestDevice Trade Federation (Tradefed) untuk mengirim atau menarik 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 dengan menggunakan perintah adb shell content dengan user, uri, dan parameter lain yang sesuai yang ditentukan.

Solusi 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 menarik file.

Solusi untuk file media

Untuk mengirim file media ke partisi media kartu SD, gunakan API publik MediaStore. 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 sudah ada yang membaca dan menulis file ke jalur /sdcard khusus pengguna.

Bangun 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 platform pengujian 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 didefinisikan 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 penonaktifan). Selain itu, jika user-cleanup disetel, user-cleanup akan otomatis mencoba membersihkan setelah pengujian, sekaligus memberikan error yang berguna sehingga pengujian dapat diperbaiki.

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

Penyiapan target

Penyiap target biasanya digunakan untuk menyiapkan perangkat dengan konfigurasi tertentu. Dalam kasus pengujian multi-pengguna, penyiapan dapat digunakan untuk membuat pengguna dengan 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, penguji 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 sudah 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 digerakkan host

Dalam beberapa kasus, pengujian perlu mengalihkan 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 host Tradefed, yang memberikan akses ke ITestDevice, sehingga memungkinkan manipulasi pengguna yang diperlukan.

Gunakan UserChecker (dijelaskan dalam Pemeriksa status) untuk pengujian yang didorong host yang mengubah status pengguna karena memastikan bahwa pengujian dibersihkan dengan benar setelah selesai.