This article explains the steps required to start testing and profiling your iOS apps using Apptim in a Mac or Windows PC.
Using a Mac
Apptim can test your iOS apps without the need for installing any third-party components, but if you want to capture performance metrics of your device (CPU, render, memory, battery consumption, etc.) you will need to install Xcode and download the device's symbols.
1.1 - Download Xcode
To collect performance data while using Apptim, you need to have Xcode installed on your Mac. You can download the latest version from the Xcode downloads page.
Note: The Xcode version supported by Apptim needs to be greater than 9.4.
1.2 - Configure command line tools location of Xcode
Open Xcode and go to Preferences:
Then, go to Locations and select Xcode in the “Command Line Tools” section. Make sure the Xcode version shown here is the latest one installed in your Mac.
1.3 - Download iOS symbols for your device
In order for Apptim to recognize your iOS device, certain symbols are required. These symbols are downloaded automatically by Xcode every time you connect your device via USB while the Xcode Application is open.
To download symbols for your device, follow these steps:
1- Open then Xcode Application with your device connected to your Mac.
2- Open Devices & Simulators (Window → Devices & Simulators | ⇧⌘2.)
3- Check that your device is recognized as connected:
Note: if you see the message "Development cannot be enabled while your device is locked", your Mac is not a "Trusted" computer. Please follow these steps to fix it:
Disconnect your iPhone (device) from your Mac.
On your iPhone (device) go to Settings > Reset > Reset Location & Privacy.
Connect your device to your Mac and answer "Trust" to the prompt.
4- Wait until the Xcode debugger process finishes. This may take up to several minutes.
Important: Every time you update the iOS version of your device, you will have to repeat this process and download new symbols to allow debugging on the device.
Using a Windows PC
1 - Install the most recent version of iTunes.
1.1 - Open iTunes, connect your iOS device using a USB cable and click "Continue" to allow your computer to access the connected device.
1.2 - Tap "Trust" on your device to trust your computer.
If you don't see any prompt to trust your device, jump to the guide below.
Trusting device troubleshooting
Disconnect and reconnect
If you connected your iOS device while your PC was booting up, there is a chance for the "Trust this computer?" prompt to glitch out. In that case, simply disconnect and reconnect the device again. Also, it’s a good idea to do this while iTunes is actively launched.
An outdated version of iTunes may cause connection issues and prevent the "Trust this computer?" prompt from showing up. Therefore, make sure that you have the most recent version of iTunes running on your PC.
To check for updates, click Help on the iTunes menu bar, and then click "Check for Updates". If you have a new update available, proceed to install it.
After installing any updates, restart your computer and relaunch iTunes. If the "Trust this computer?" message shows up on your iOS device, tap Trust. If it doesn’t show up, move to the next section.
Restart your iOS device. Usually, this fixes any lingering issues and glitches that prevent the "Trust this computer?" pop-up from not showing.
Before restarting, make sure to disconnect the iOS device from your computer.
After your device fully shuts down, press and hold the power button again to restart it.
With iTunes launched on your PC, connect your device. If the "Trust this computer?" prompt still doesn’t appear, continue to the next section.
Reset trust settings in your iOS device
1- Tap "General" on the "Settings" screen, and then tap "Reset".
2- Next, tap "Reset Location & Privacy".
3- Tap "Reset".
Reset network settings in your iOS device
1- On the "Settings" screen, tap "General", and then tap "Reset". Now, tap "Reset Network" "Settings".
2- Tap "Reset".
If you have questions when setting up your iOS device, feel free to reach out to our team for help at [email protected].