On this page, we will explain the procedures for creating and running tests on various combinations of local PC environments.
Table of Contents
- Android real device + apk file test
- Android real device + installed app test
- iOS real device + ipa file test
- iOS + installed app test
1. Android real device + apk file test
The procedure for creating and running tests using an actual Android device and an apk file, which is the substance of the Android application, is generally the same as for iOS. However, the method of specifying the OS/app and the method of acquiring screen captures are slightly different from those for iOS.
When you use an apk file, select Android in the OS field and .apk file in the App Type field and enter the full path in the Enter full path to .apk file field.
Figure 1. Specify the OS and app for Android.
An apk file path is the same as in case of iOS, so right-click the app file while holding down the option(alt) key and clicking Copy "********" as Pathname.
Figure 2. Copy the apk file path name.
Next, before clicking the button to connect to the device, connect the Android real device to the PC with the USB cable. Unlock the device. Furthermore, the Allow USB debugging dialog box will appear, so tap OK to allow debugging.
Figure 3. Allow USB debugging dialog box.
After connecting the device, when you click Connect, and wait for a while, the apk file app will be installed on the real device, and the app will launch.
Figure 4. Connect button.
You can then acquire the screen capture, and create and run the test for this app.
Figure 5. Tests created in relation to the apk file app.
Incidentally, if the same operation is performed while the Android emulator is launched, it will also be possible to actually perform the test using the Android emulator.
2. Android actual device + installed app test
With the MagicPod, it is also possible to test apps installed on the Android real device (the apk file is also unnecessary and it does not need to be our own app). In this case, you can specify the tested app using the Package/Activity system information.
Figure 6. Package/Activity.
The Package/Activity value in the app can be looked up using the following method.
- Connect the Android real device to the PC using the USB cable.
- Set OS to Android, leave the Package/Activity value blank, click Connect, and connect to the device.
- Once the connection is established, operate the device manually, and launch the app to be tested.
- Open the test run settings panel, and click Get app info. After a short wait, the Package/Activity information for the app being launched will be set.
Figure 7. Acquire Package/Activity for app being launched.
Once you acquire the Package/Activity information and connect to and launch the specified app with this information, you can acquire screen captures, create tests, and run tests.
3. iOS real device + ipa file test
When you use the iOS real device and the ipa file that is the content of the iOS app to run the test, specify the following values for the test target.
- OS: iOS
- Device Type: Real Device
- Team ID: Enter Apple developer program team ID
- App Type: .ipa file
- Enter full path to .ipa file: Full path to the ipa file on your PC
Figure 8. Method of specifying the iOS real device + ipa file test.
By simply connecting the iOS real device to the PC using the USB cable, you can acquire the screen capture and run the test.
- Unlock the device.
- As the confirmation dialog shown in figure 9 is displayed, tap Trust.
- If you encounter other errors that prevent you from connecting to the device or running the test, try this workaround.
Figure 9. iOS real device confirmation dialog box.
Real devices of iOS/iPadOS 16 or later require enabling developer mode.
4. iOS + installed app test
With MagicPod, it is possible to test apps installed on the iOS simulator or on a real device (neither the app file or ipa file are necessary, and it does not need to be our own app). In this case, you specify the app to be tested with the system information called Bundle ID.
Figure 10. Bundle ID.
It is possible to look up the app bundle ID using the following method.
- In case of an app published on the Apple App Store, these can be looked up by entering the name of the app or the App Store page URL on the Bundle ID Finer
- A list of bundle IDs can be found here for the apps that are installed on the device.
If you encounter other errors that prevent you from connecting to the device or running the test, try this workaround.