Deploying projects to Android devices

Below are the methods currently supported for deploying your TracerPlus Desktop projects to Android OS devices.

Method 1: WIFI/QR Code deployment (Recommended)

This method supports most android devices and requires your device & PC to be on the same network.

 From the Select Platform drop-down, choose the Android option.

1. Open your TracerPlus Desktop project and click the Build/Deploy option.
2. Under the Android Connection Options, select Use Deploy Server to open the QR code window.
3. Open TracerPlus on your device and select the Menu Bar.
4. On the Menu Bar, select Download Project.
5. From the Connect to Web Server window, click the Scan QR Code option.
   1. Zebra, Janam, and CipherLab devices equipped with a 2D scanner can scan the barcode with this scanner.
   2. All other devices can select Use Camera from the Scan QR Code Window.
6. Use the camera or barcode scanner to scan the QR code on your PC and wait for the download Successful message.
7. Alternatively, if your device does not have a camera or built-in scanner, you can key in the IP Address: Port  (IE: http://192.168.1.105:4409) to the Address field, then click the Refresh icon next to the Project Drop Down. Select the Project and click the Download button.
8. You should now see your TracerPlus application as designed in TracerPlus Desktop.

Method 2: Manual copy of files

If you are unable to connect your device to WiFi/WAN/Ethernet to use Method 1 above or if the device and PC are on different networks you can manually copy the deployment files to it. Follow the instructions below to manually copy the necessary files over.

1. Open your TracerPlus Desktop project and click the Build\Deploy option.
2. Click the Build only option and then click Build.
3. Navigate to \Deploy\SystemInfo\Skins in your TracerPlus Desktop Project's folder.
4. Make sure TracerPlus is fully exited on the handheld by killing it from the running applications.
5. Connect your Android device to your PC via the supplied USB cable or Cradle.
6. Make sure the USB Connection type is set to Transfer Files vs the Default of USB Charging on the handheld.
7. Browse the Android device using My Computer on your PC.
8. Copy all .tac files from the above Skins folder into the /Android/data/com.pts.tracerplus10/files/systeminfo/system folder on the Android device.
9. Navigate to \Deploy\SystemInfo\System in your TracerPlus Desktop Project folder.
10. Copy all .tac files from the above System folder into the /Android/data/com.pts.tracerplus10/files/systeminfo/system folder on the Android device.
11. If you created any drop down lists and added values to them within the project, navigate to \Deploy\Data\For_import, then copy all .txt files to the /Android/data/com.pts.tracerplus10/files/data/for_import  folder on the Android device
12. Launch TracerPlus and you should now see your TracerPlus application as designed in TracerPlus Desktop.
13. Note that users of 3rd party MDM (Mobile Device Management) solutions can use these same files to deploy remotely to connected devices using the MDM's built in job deployment.

Method 3: MTP (Media Transfer Protocol)

This method sometimes supports older Android devices with older versions of Android OS but is not reliable based on how Windows interacts with the Android File System. We recommend using Method 1 and 2 before trying this method.

1. Connect your Android device to your PC via the supplied USB cable.
2. For most devices you will be required to switch from USB Charging to Transfer Files.
   1. Swipe down from the top of the screen to reveal the notifications.
   2. Click on the USB Charging option and tap for more options.
   3. Change to Transfer Files
3. Open your TracerPlus Desktop project and click the Build\Deploy option.
4. From the Select Platform drop-down choose the Android option.
5. Under the Android Connection Options, select Use Portable Device (MTP).
6. Choose your device from the Drop Down.
7. Click the Deploy option and the project will be deployed to your Android device.
8. Launch TracerPlus and you should now see your TracerPlus application as designed in TracerPlus Desktop.

Method 4: Connecting using Android Debug Bridge

This method requires that the Android Debug Bridge (ADB) server is running on your PC. Click Here to download the Android Debug Bridge server. We have found that this only works on a limited number of Android devices so it may not work with your device. Follow the instructions below to start the ADB server followed by instructions on deploying your TracerPlus Desktop project. We recommend using Method 1 and 2 before trying this method.

After downloading the ADB server software above, you will need to do the following:

1. Unzip the contents of the download. There will be 3 files (adb.exe, AdbWinApi.dll, AdbWinUsbApi.dll).
2. Copy these 3 files to the root of your C:\ drive on your PC.
3. Open a command prompt window by clicking Start and then type cmd in the search box followed by the Enter key (Windows 7).
4. The directory will most likely default to your user folder. This needs to be changed to C:\. To do so type cd\ followed by the Enter key. The prompt should now show as C:\.
5. Type the command ADB start-server and you will see the server start. To verify it is running you can open your Windows task manager and look for a process named adb.exe.
6. You may now proceed to deploying your project below.

Deploying your TracerPlus Desktop Project:

1. On your Android device, you will need to turn on USB Debugging. How this is enabled will vary based on the Android OS version.
2. This option is located under Developer Options or Development in the settings of your Android device. This option may be at the root of your device settings or under the Applications area.
3. Check the box to turn this feature on.
4. Connect your Android device to your PC via the supplied USB cable.
5. You may need to install your device's driver for it to recognize correctly as an ADB device.
6. To test that it is connected as an ADB device do the following:
   1. Open a command prompt window and type cd\
   2. Type the command: ADB devices
   3. This will show if any ADB devices are connected
7. Open your TracerPlus Desktop project and click the Build\Deploy option.
8. From the Select Platform, drop-down choose the Android option.
9. Under the Android Connection Options it should default to the correct option if the connection is recognized by TracerPlus Desktop. This should be the Use Android Debug Bridge option. (If this option is grayed out then your device does not support this type of connection or USB Debugging wasn't enabled in the settings)
10. Click the Deploy option and the project will be deployed to your Android device.
11. Launch TracerPlus and you should now see your TracerPlus application as designed in TracerPlus Desktop.