How to Adapt Applications for Q1 (4G) Devices: Difference between revisions

Revision as of 17:43, 27 December 2023

Overview

Applications designed for earlier versions of Android or non-4G Q1 terminals need to be debugged for the Q1 (4G) terminal, which runs on Android version 7.0.

Common Issues and Solutions

Library Compatibility Issue:
- Problem: Error message "dlopen failed: library 'libwizarposHAL.so' not found".
- Solution: Contact WizarPOS for support. The 'libwizarposHAL.so' library is incompatible with Q1 (4G) and needs to be replaced with 'libwizarposdriver.so'.
Compiled SO Files Usage:
- If your application uses compiled SO files, update your project with the JNIInterface and SO files from the latest APIDemo.
MAC Address Randomization in First Batch of Q1 Terminals:
- Note: The MAC address of the initial batch of Q1 terminals is random. This means the Bluetooth address updates every time the terminal restarts.

@@ Line 1: / Line 1: @@
-The Android version of Q1 (4G) terminal is 7.0, so the application of the lower version should be debugged in Q1 (4G) before use, even if the application runs successfully in Q1 (non 4G) terminal. Here are some of the problems we encountered:
+== Overview ==
+Applications designed for earlier versions of Android or non-4G Q1 terminals need to be debugged for the Q1 (4G) terminal, which runs on Android version 7.0.
-* When the error "dlopen failed: library "libwizarposHAL.so" not found" is encountered, please contact WizarPOS. This system library cannot run in Q1(4G), and should be replaced with libwizarposdriver.so.
+== Common Issues and Solutions ==
-* If your application uses compiled so files, copy the JNIInterface and so files from the latest APIDemo to your project.
+# '''Library Compatibility Issue:'''
-* Please note that the MAC address of the first batch of Q1 terminals is random. Every time the terminal restarts, the Bluetooth address will be updated.
+#* '''Problem:''' Error message "dlopen failed: library 'libwizarposHAL.so' not found".
+#* '''Solution:''' Contact WizarPOS for support. The 'libwizarposHAL.so' library is incompatible with Q1 (4G) and needs to be replaced with 'libwizarposdriver.so'.
+# '''Compiled SO Files Usage:'''
+#* If your application uses compiled SO files, update your project with the JNIInterface and SO files from the latest APIDemo.
+# '''MAC Address Randomization in First Batch of Q1 Terminals:'''
+#* '''Note:''' The MAC address of the initial batch of Q1 terminals is random. This means the Bluetooth address updates every time the terminal restarts.