Birden fazla kullanıcıyı test etme

Bu sayfada, Android platformunda birden fazla kullanıcıyı test etmenin önemli yönleri açıklanmaktadır. Çok kullanıcılı desteği uygulama hakkında bilgi edinmek için Birden fazla kullanıcıyı destekleme başlıklı makaleyi inceleyin.

Cihaz yolları

Aşağıdaki tabloda, cihaz yollarından bazıları ve bunların nasıl çözüldüğü listelenmiştir. Yol sütunundaki tüm değerler, kullanıcıya özel korumalı bir depolama alanıdır. Android'in depolama alanı zaman içinde değişti. Daha fazla bilgi için Depolama belgelerini inceleyin.

Kullanıcıya özel bir yol kullanma örneğini aşağıda bulabilirsiniz:

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

Kullanıcılar arasında adb etkileşimleri

Birden fazla kullanıcıyla çalışırken çeşitli adb komutları faydalıdır. Aşağıdaki komutlardan bazıları yalnızca Android 9 ve sonraki sürümlerde desteklenir:

• adb shell am instrument --user <userId>, belirli bir kullanıcıya karşı bir araç testi çalıştırır. Varsayılan olarak mevcut kullanıcı kullanılır.
• adb install --user <userId>, belirli bir kullanıcı için bir paket yükler. Bir paketin tüm kullanıcılar için yüklenmesini sağlamak istiyorsanız bu işlevi her kullanıcı için çağırmanız gerekir.
• adb uninstall --user <userId>, belirli bir kullanıcının paketini kaldırır. Yüklemeyi tüm kullanıcılar için kaldırmak üzere --user işareti olmadan çağrı yapın.
• adb shell am get-current-user, mevcut (ön plan) kullanıcı kimliğini alır.
• adb shell pm list users, mevcut tüm kullanıcıların listesini alır.
• adb shell pm create-user, yeni bir kullanıcı oluşturup kimliği döndürür.
• adb shell pm remove-user, kimliğe göre belirli bir kullanıcıyı kaldırır.
• adb shell pm disable --user <userId>, belirli bir kullanıcı için bir paketi devre dışı bırakır.
• adb shell pm enable --user <userId>, belirli bir kullanıcı için bir paketi etkinleştirir.
• adb shell pm list packages --user <userId>, belirli bir kullanıcının paketlerini (etkin için -e, devre dışı için -d) listeler. Varsayılan olarak bu, her zaman sistem kullanıcısı için listelenir.

Aşağıdaki bilgiler, adb'ün birden fazla kullanıcıyla nasıl davrandığını açıklamaya yardımcı olur:

• adb (veya daha doğrusu adbd daemon'ı) mevcut kullanıcıdan bağımsız olarak her zaman sistem kullanıcısı (kullanıcı kimliği = 0) olarak çalışır. Bu nedenle, kullanıcıya bağlı cihaz yolları (/sdcard/ gibi) her zaman sistem kullanıcısı olarak çözülür. Daha fazla bilgi için Cihaz yolları başlıklı makaleyi inceleyin.

• Varsayılan bir kullanıcı belirtilmezse her adb alt komutunun farklı bir kullanıcısı olur. En iyi uygulama, kullanıcı kimliğini am get-current-user ile almak ve ardından bunu destekleyen tüm komutlar için --user <userId>'yi açıkça kullanmaktır. Android 9'a kadar açık kullanıcı işaretleri tüm komutlar için desteklenmiyordu.

• Android 9'dan itibaren ikincil kullanıcıların /sdcard yollarına erişim reddedilir. Test sırasında dosyaların nasıl alınacağıyla ilgili ayrıntılar için Çok kullanıcılı veriler için içerik sağlayıcı başlıklı makaleyi inceleyin.

Çok kullanıcılı veriler için içerik sağlayıcı

adb sistem kullanıcısı olarak çalıştığı ve veriler Android 9 ve sonraki sürümlerde korumalı alanda bulunduğu için sistem kullanıcısı olmayan bir kullanıcıdan test verilerini göndermek veya almak için içerik sağlayıcıları kullanmanız gerekir. Aşağıdaki durumlarda bu işlem gerekmez:

• adbd, kök olarak (adb root üzerinden) çalışıyor. Bu, yalnızca userdebug veya usereng derlemeleri kullanılarak yapılabilir.

• Dosyaları göndermek veya almak için Trade Federation'ın (Tradefed) ITestDevice sürümünü kullanıyorsanız test yapılandırmanızda /sdcard/ yollarını kullanın (örneğin, NativeDevice.java içindeki pushFile için kaynak koda bakın).

İkincil kullanıcıda çalışan bir içerik sağlayıcıya, uygun user, uri ve diğer parametrelerle birlikte adb shell content komutunu kullanarak erişebilirsiniz.

Uygulama geliştiriciler için geçici çözüm

push veya pull komutu yerine adb content ve ContentProvider örneğini kullanarak test dosyalarıyla etkileşime geçin.

1. Uygulama tarafından barındırılan ve gerektiğinde dosya yayınlayıp depolayabilen bir ContentProvider örneği oluşturun. Uygulamanın dahili depolama alanını kullanın.
2. Dosyaları göndermek veya almak için adb shell content read veya write komutlarını kullanın.

Medya dosyaları için geçici çözüm

Medya dosyalarını SD kartın medya bölümüne aktarmak için MediaStore genel API'lerini kullanın. Örneğin:

# 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

Genel içerik sağlayıcı yükleme

Kullanıcıya özel /sdcard yoluna dosya okuyup yazan mevcut bir içerik sağlayıcıyı yükleyip kullanın.

make TradefedContentProvider kullanarak TradefedContentProvider.apk'ü kaynaktan derleyin:

```
# 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
```

Trade Federation çok kullanıcılı desteği

Tradefed, resmi Android test aracıdır. Bu bölümde, Tradefed'in çok kullanıcılı test senaryoları için yerleşik desteğinin bir kısmı özetlenmiştir.

Durum kontrolörleri

Sistem durumu kontrolörleri (SSC'ler), hedef hazırlayıcılardan önce çalıştırılır ve temizleme işlemleri bu hazırlayıcılardan sonra çalıştırılır.

UserChecker, geliştiricilerin birden fazla kullanıcıyı test ederken yardımcı olması için açıkça tanımlanır. Bir testin cihazdaki kullanıcıların durumunu değiştirip değiştirmediğini (ör. kullanıcıları kaldırmadan teardown'da oluşturma) izler. Ayrıca, user-cleanup ayarlanmışsa testin düzeltilebilmesi için yararlı hatalar sağlarken testten sonra otomatik olarak temizleme işlemini gerçekleştirmeye çalışır.

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

Hedef hazırlayan

Hedef hazırlayıcılar genellikle bir cihazı belirli bir yapılandırmayla ayarlamak için kullanılır. Birden fazla kullanıcının yer aldığı testlerde, belirli bir türde kullanıcı oluşturmak ve diğer kullanıcılara geçmek için hazırlayıcılar kullanılabilir.

İkincil kullanıcısı olmayan cihaz türlerinde, AndroidTest.xml'da ikincil kullanıcı oluşturmak ve bu kullanıcıya CreateUserPreparer ile geçmek içinAndroidTest.xml'ı kullanabilirsiniz. Hazırlayıcı, testin sonunda tekrar birincil kullanıcıya geçer ve ikincil kullanıcıyı siler.

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

İstediğiniz kullanıcı türü cihazda zaten mevcutsa mevcut kullanıcıya geçmek için SwitchUserTargetPreparer simgesini kullanın. user-type için yaygın değerler system veya secondary'dir.

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

Ana makine tarafından yürütülen testler

Bazı durumlarda, bir testin test içinde kullanıcıları değiştirmesi gerekir. Test işlemi herhangi bir zamanda sonlandırılabileceğinden, UI Otomasyonu gibi cihaz tarafında bir test çerçevesi içinden geçiş yapmayın. Bunun yerine, Tradefed'in ana makine tarafı test çerçevesi gibi bir ana makine tarafı test çerçevesi kullanın. Bu çerçeve, ITestDevice'a erişim sağlar ve gerekli tüm kullanıcı manipülasyonlarını yapmanıza olanak tanır.

UserChecker (Durum kontrolörleri bölümünde açıklanmıştır) kullanıcı durumunu değiştiren, barındırıcı tarafından yürütülen testler için kullanın. Bu, testin kendinden sonra düzgün bir şekilde temizlenmesini sağlar.