Menambahkan file tambahan ke paket pengujian Anda di Device Farm

Anda mungkin ingin menggunakan file tambahan sebagai bagian dari pengujian Anda baik sebagai file konfigurasi tambahan atau data pengujian tambahan. Anda dapat menambahkan file tambahan ini ke paket pengujian sebelum mengunggahnya AWS Device Farm, lalu mengaksesnya dari mode lingkungan khusus. Pada dasarnya, semua format upload paket uji (ZIP, IPA, APK, JAR, dll.) adalah format arsip paket yang mendukung operasi ZIP standar.

Anda dapat menambahkan file ke arsip pengujian sebelum mengungg AWS Device Farm ahnya dengan menggunakan perintah berikut:

$ zip zip-with-dependencies.zip extra_file

Untuk direktori file tambahan:

$ zip -r zip-with-dependencies.zip extra_files/

Perintah ini berfungsi seperti yang diharapkan untuk semua format unggahan paket pengujian kecuali untuk file IPA. Untuk file IPA, terutama bila digunakan dengan XCUITests, kami sarankan Anda meletakkan file tambahan di lokasi yang sedikit berbeda karena cara mengundurkan diri paket pengujian AWS Device Farm iOS. Saat membangun tes iOS Anda, direktori aplikasi pengujian akan ditempatkan di dalam direktori lain bernamaPayload.

Misalnya, ini adalah bagaimana salah satu direktori pengujian iOS tersebut dapat terlihat:

$ tree
.
└── Payload
    └── ADFiOSReferenceAppUITests-Runner.app
        ├── ADFiOSReferenceAppUITests-Runner
        ├── Frameworks
        │   ├── XCTAutomationSupport.framework
        │   │   ├── Info.plist
        │   │   ├── XCTAutomationSupport
        │   │   ├── _CodeSignature
        │   │   │   └── CodeResources
        │   │   └── version.plist
        │   └── XCTest.framework
        │       ├── Info.plist
        │       ├── XCTest
        │       ├── _CodeSignature
        │       │   └── CodeResources
        │       ├── en.lproj
        │       │   └── InfoPlist.strings
        │       └── version.plist
        ├── Info.plist
        ├── PkgInfo
        ├── PlugIns
        │   ├── ADFiOSReferenceAppUITests.xctest
        │   │   ├── ADFiOSReferenceAppUITests
        │   │   ├── Info.plist
        │   │   └── _CodeSignature
        │   │       └── CodeResources
        │   └── ADFiOSReferenceAppUITests.xctest.dSYM
        │       └── Contents
        │           ├── Info.plist
        │           └── Resources
        │               └── DWARF
        │                   └── ADFiOSReferenceAppUITests
        ├── _CodeSignature
        │   └── CodeResources
        └── embedded.mobileprovision

Untuk paket XCUITest ini, tambahkan file tambahan apa pun ke direktori yang berakhir di .app dalam direktori. Payload Misalnya, perintah berikut menunjukkan bagaimana Anda dapat menambahkan file ke paket pengujian ini:

$ mv extra_file Payload/*.app/
$ zip -r my_xcui_tests.ipa Payload/

Saat menambahkan file ke paket pengujian, Anda dapat mengharapkan perilaku interaksi yang sedikit berbeda AWS Device Farm berdasarkan format unggahannya. Jika unggahan menggunakan ekstensi file ZIP, AWS Device Farm akan secara otomatis unzip unggahan sebelum pengujian Anda dan meninggalkan file yang tidak di-zip di lokasi dengan variabel lingkungan. $DEVICEFARM_TEST_PACKAGE_PATH (Ini berarti bahwa jika Anda menambahkan file yang extra_file dipanggil ke root arsip seperti pada contoh pertama, itu akan ditempatkan di $DEVICEFARM_TEST_PACKAGE_PATH/extra_file selama pengujian).

Untuk menggunakan contoh yang lebih praktis, jika Anda pengguna Appium TestNG yang ingin menyertakan testng.xml file dengan pengujian Anda, Anda dapat memasukkannya ke dalam arsip Anda menggunakan perintah berikut:

$ zip zip-with-dependencies.zip testng.xml

Kemudian, Anda dapat mengubah perintah pengujian Anda dalam mode lingkungan khusus menjadi berikut:

java -D appium.screenshots.dir=$DEVICEFARM_SCREENSHOT_PATH org.testng.TestNG -testjar *-tests.jar -d $DEVICEFARM_LOG_DIR/test-output $DEVICEFARM_TEST_PACKAGE_PATH/testng.xml

Jika ekstensi unggahan paket pengujian Anda bukan ZIP (misalnya, file APK, IPA, atau JAR), file paket yang diunggah itu sendiri ditemukan di$DEVICEFARM_TEST_PACKAGE_PATH. Karena ini masih file format arsip, Anda dapat unzip file untuk mengakses file tambahan dari dalam. Misalnya, perintah berikut akan unzip isi paket pengujian (untuk file APK, IPA, atau JAR) ke /tmp direktori:

unzip $DEVICEFARM_TEST_PACKAGE_PATH -d /tmp

Dalam kasus file APK atau JAR, Anda akan menemukan file tambahan Anda diunzip ke /tmp direktori (mis.,/tmp/extra_file). Dalam kasus file IPA, seperti yang dijelaskan sebelumnya, file tambahan akan berada di lokasi yang sedikit berbeda di dalam folder yang diakhiri .app dengan, yang ada di dalam Payload direktori. Misalnya, berdasarkan contoh IPA di atas, file akan ditemukan di lokasi /tmp/Payload/ADFiOSReferenceAppUITests-Runner.app/extra_file (dapat dirujuk sebagai/tmp/Payload/*.app/extra_file).

Untuk lebih banyak cara untuk memperluas rangkaian pengujian dan mengoptimalkan pengujian Anda, lihatMemperluas lingkungan pengujian khusus di Device Farm.