Troubleshooting
This guide introduces some common errors that you might encounter when building your POS UI extension, and provides some resolutions to help resolve unexpected errors.
Extension QR code does not work on Android
Anchor link to section titled "Extension QR code does not work on Android"
Android devices can have a restriction on how deep links are handled. To resolve this issue, you can use one of the following options:
Connect the device to your computer. Use Android Studio to open your deep link by running the following command:
adb shell am start "com.shopify.pos://pos-ui-extensions?url=<EXTENSION_URL>"
. Replace<EXTENSION_URL>
with the URL that you want to test.Download and use a deep link opener app from Play Store.
Could not resolve "..."
Anchor link to section titled "Could not resolve "...""
This error is most likely from missing a dependency in package.json in the app root. Try re-installing your dependecies and running the app again.
'...' cannot be used as a JSX component
Anchor link to section titled "'...' cannot be used as a JSX component"
This issue commonly happens when Yarn
is used for dependency management. The package's version was updated but npm
conflicts with Yarn
. In the root of your application run npm install
to get it up to date as well. Restart your IDE if necessary.