Skip to main content

APK Setup

The APK setup is quite simple.
You need to install the PhonePOS APP on the device and add a "query" parameter in your manifest.

Query parameter in Manifest file​

To ensure smooth integration and functionality, please follow the steps below to add a query parameter to your Android app's manifest file.

Step 1: Open Your Android App's Manifest File​

Navigate to the AndroidManifest.xml file located in the app directory of your Android Studio project.

Step 2: Add Query Parameter to <queries> Section​

Within the <manifest> element of your AndroidManifest.xml file, locate the <queries> section. If it doesn't exist, create it. Then, add the following code snippet inside the <queries> section:

<manifest>
    ...
    <queries>
        <package android:name="PhonePOS Application Id" />
    </queries>
    ...
</manifest>

Replace "PhonePOS Application Id" with the actual package name of your PhonePOS APK.

tip

The package name for the QA and the PROD PhonePOS APK will be different. It is advised to make this configurable in your integration.

Step 3: Save Your Changes​

Save the AndroidManifest.xml file after adding the query parameter.

Step 4: Build and Test Your App​

Build your Android app to ensure that the changes are incorporated correctly. Test the integration with PhonePOS APK using intents to confirm that the integration works as expected.

Additional Notes:​

  • Ensure that the package name specified in the <package> element matches the package name of PhonePOS APK exactly.
  • If you encounter any issues during integration or have questions, please refer to the documentation provided with PhonePOS APK or reach out to our support team for assistance.

Keep in mind:​

  • Users might uninstall an app, including the PhonePOS APK
  • Android itself can freeze apps when they are not used for an extended period of time
  • An APK only requires to check if the app installed
Implementation recommendation

It is recommended that you check the presence of the PhonePOS APK before you do calls to it.
If this check returns a negative result you might need to offer a PlayStore or another link to make it possible for the user to install the PhonePOS APK again.
This handling depends on your use case scenario.