@nitra/zebra 7.0.0 → 7.1.0

package/NitraZebra.podspec

@@ -13,5 +13,6 @@ Pod::Spec.new do |s|
   s.source_files = 'ios/Sources/**/*.{swift,h,m,c,cc,mm,cpp}'
   s.ios.deployment_target = '15.0'
   s.dependency 'Capacitor'
+  s.frameworks = 'ExternalAccessory'
   s.swift_version = '5.1'
 end

package/Package.swift

@@ -19,7 +19,10 @@ let package = Package(
                 .product(name: "Capacitor", package: "capacitor-swift-pm"),
                 .product(name: "Cordova", package: "capacitor-swift-pm")
             ],
-            path: "ios/Sources/ZebraPlugin"),
+            path: "ios/Sources/ZebraPlugin",
+            linkerSettings: [
+                .linkedFramework("ExternalAccessory")
+            ]),
         .testTarget(
             name: "ZebraPluginTests",
             dependencies: ["ZebraPlugin"],

package/README.md

@@ -18,29 +18,62 @@ npx cap sync
 
 ## API
 
-### `print(value: string): Promise<boolean>`
+### `print(zpl: string | PrintOptions): Promise<{ sent?: boolean }>`
 
 Відправляє ZPL-команду на принтер Zebra.
 
-| Платформа   | Поведінка                                                                                                       |
-| ----------- | --------------------------------------------------------------------------------------------------------------- |
-| **Web**     | Запитує порт через Web Serial API, відкриває з'єднання (9600 baud) і відправляє рядок ZPL на вибраний пристрій. |
-| **iOS**     | Нативна реалізація (через плагін).                                                                              |
-| **Android** | Нативна реалізація (через плагін).                                                                              |
+| Платформа   | Поведінка                                                                                                                                                           |
+| ----------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
+| **Web**     | Запитує порт через Web Serial API, відкриває з'єднання (9600 baud) і відправляє рядок ZPL на вибраний пристрій.                                                     |
+| **iOS**     | Друк по **Bluetooth (MFi)**. Принтер спочатку спарюють у Налаштування → Bluetooth; далі `getPairedDevices()` та `print({ zpl, address })`.                          |
+| **Android** | Відправка ZPL по **Bluetooth Classic (SPP)**. Потрібно спочатку викликати `setPrinterAddress({ address: "MAC" })` або передати `address` (Bluetooth MAC) у виклику. |
 
-**Параметри:**
+**Параметри (об'єкт для Android):**
 
-- `value` — рядок з ZPL-командами (наприклад, `^XA^FO50,50^A0N,28,28^FDHello^FS^XZ`).
+- `zpl` — рядок ZPL-команд (наприклад, `^XA^FO50,50^A0N,28,28^FDHello^FS^XZ`).
+- `address` — (Android, опційно) Bluetooth MAC-адреса принтера (наприклад `00:11:22:33:44:55`); якщо не передано, використовується збережена через `setPrinterAddress()`.
+- `port` — ігнорується (для сумісності API).
 
 **Приклад:**
 
 ```javascript
-import { Zebra } from "@nitra/zebra";
+import { Zebra } from '@nitra/zebra'
+
+const zpl = '^XA^FO50,50^A0N,28,28^FDHello World^FS^XZ'
+await Zebra.print(zpl)
+```
+
+### `setPrinterAddress(options: { address: string, port?: number }): Promise<{ address }>` (Android / iOS)
+
+Зберігає Bluetooth MAC-адресу принтера Zebra для подальших викликів `print(zpl)` без передачі адреси.
+
+**Параметри:**
+
+- `address` — на Android: Bluetooth MAC (наприклад `00:11:22:33:44:55`); на iOS: серійний номер або ім'я з `getPairedDevices()`.
+- `port` — ігнорується (для сумісності API).
+
+**Приклад (Android):**
+
+```javascript
+await Zebra.setPrinterAddress({ address: '00:11:22:33:44:55' })
+await Zebra.print(zpl)
+```
+
+**Приклад (iOS):** використовуйте `address` з `getPairedDevices()` (серійний номер або ім'я принтера).
+
+### `getPairedDevices(): Promise<{ devices: { address: string, name: string }[] }>` (Android / iOS)
 
-const zpl = "^XA^FO50,50^A0N,28,28^FDHello World^FS^XZ";
-await Zebra.print(zpl);
+Повертає список пристроїв: на Android — спарені Bluetooth-пристрої; на iOS — підключені MFi-аксесуари (Bluetooth). Корисно для вибору принтера. На Android 12+ потрібен дозвіл **BLUETOOTH_CONNECT** (запитати до виклику).
+
+**Приклад (Android):**
+
+```javascript
+const { devices } = await Zebra.getPairedDevices()
+// devices: [{ address: "00:11:22:33:44:55", name: "Zebra ZD420" }, ...]
 ```
 
+**Приклад (iOS):** той самий API; `address` — серійний номер або ім'я MFi-пристрою.
+
 ## Веб (Web Serial API)
 
 На веб-платформі плагін використовує Web Serial API:
@@ -51,6 +84,36 @@ await Zebra.print(zpl);
 
 **Обмеження:** Web Serial API працює лише в підтримуваних браузерах (Chrome, Edge, Opera) і зазвичай лише через HTTPS або localhost.
 
+## Android (Bluetooth Classic)
+
+На Android плагін відправляє ZPL на принтер Zebra по **Bluetooth Classic** (профіль SPP):
+
+1. Спаріть принтер у налаштуваннях Bluetooth пристрою.
+2. Викличте `getPairedDevices()` щоб отримати список пристроїв (опційно) або введіть MAC-адресу вручну.
+3. Викличте `setPrinterAddress({ address: "MAC_ПРИНТЕРА" })` один раз (наприклад, з налаштувань) або передайте `address` у виклику `print({ zpl, address })`.
+4. Викличте `print(zpl)` або `print({ zpl })` — ZPL буде відправлено на принтер по Bluetooth.
+
+Потрібні дозволи **BLUETOOTH**, **BLUETOOTH_ADMIN** (до API 30), **BLUETOOTH_CONNECT** (API 31+). На Android 12+ дозвіл `BLUETOOTH_CONNECT` потрібно запитати під час виконання (наприклад перед `getPairedDevices()` або `print()`).
+
+## iOS (Bluetooth MFi)
+
+На iOS друк працює лише по **Bluetooth** через **ExternalAccessory** (MFi). Підключення по Lightning/USB не підтримується Apple для Zebra в цьому режимі.
+
+1. **Спаріть принтер:** Налаштування → Bluetooth → увімкніть принтер і підключіть його.
+2. **У додатку:** викличте `getPairedDevices()` — повернуться підключені Zebra-пристрої (`address` та `name`).
+3. Викличте `setPrinterAddress({ address })` або передайте `address` у `print({ zpl, address })` (адреса — це `address` з `getPairedDevices()`: серійний номер або ім'я).
+4. `print({ zpl, address })` відправляє ZPL на принтер по Bluetooth.
+
+**Обов'язково:** У проєкті додатку в `ios/App/App/Info.plist` мають бути протоколи Zebra в `UISupportedExternalAccessoryProtocols`, інакше iOS не покаже принтер:
+
+```xml
+<key>UISupportedExternalAccessoryProtocols</key>
+<array>
+  <string>com.zebra.rawport</string>
+  <string>com.zebra.print</string>
+</array>
+```
+
 ## Структура пакету
 
 - `dist/` — зібраний JS-плагін (rolldown)

package/android/src/main/AndroidManifest.xml

@@ -1,2 +1,5 @@
 <manifest xmlns:android="http://schemas.android.com/apk/res/android">
+    <uses-permission android:name="android.permission.BLUETOOTH" android:maxSdkVersion="30" />
+    <uses-permission android:name="android.permission.BLUETOOTH_ADMIN" android:maxSdkVersion="30" />
+    <uses-permission android:name="android.permission.BLUETOOTH_CONNECT" />
 </manifest>

package/android/src/main/java/dev/nitra/zebra/Zebra.java

@@ -1,11 +1,164 @@
 package dev.nitra.zebra;
 
+import android.Manifest;
+import android.bluetooth.BluetoothAdapter;
+import android.bluetooth.BluetoothDevice;
+import android.bluetooth.BluetoothSocket;
+import android.content.Context;
+import android.content.SharedPreferences;
+import android.content.pm.PackageManager;
+import android.os.Build;
+
+import androidx.core.app.ActivityCompat;
+
 import com.getcapacitor.Logger;
 
+import java.io.IOException;
+import java.io.OutputStream;
+import java.nio.charset.StandardCharsets;
+import java.util.ArrayList;
+import java.util.List;
+import java.util.Set;
+import java.util.UUID;
+import java.util.concurrent.ExecutorService;
+import java.util.concurrent.Executors;
+
+/**
+ * Реалізація друку ZPL на принтері Zebra через Bluetooth Classic (SPP).
+ */
 public class Zebra {
 
-    public String echo(String value) {
-        Logger.info("Echo", value);
-        return value;
+    /** Стандартний UUID для профілю послідовного порту (SPP) */
+    private static final UUID SPP_UUID = UUID.fromString("00001101-0000-1000-8000-00805F9B34FB");
+
+    private static final String PREFS_NAME = "ZebraPrinter";
+    private static final String KEY_ADDRESS = "printer_address";
+
+    // Потік для виконання операцій друку у фоновому режимі
+    private final ExecutorService executor = Executors.newSingleThreadExecutor();
+
+    /**
+     * Зберігає адресу та порт принтера в налаштуваннях застосунку.
+     */
+    public void setPrinterAddress(Context context, String address, int port) {
+        SharedPreferences prefs = context.getSharedPreferences(PREFS_NAME, Context.MODE_PRIVATE);
+        String normalized = address != null ? address.trim() : "";
+        prefs.edit().putString(KEY_ADDRESS, normalized).apply();
+        Logger.info("Zebra", "Адресу принтера збережено: " + normalized);
+    }
+
+    /**
+     * Отримує список спарених Bluetooth-пристроїв.
+     */
+    public List<BluetoothDeviceInfo> getPairedDevices(Context context) {
+        List<BluetoothDeviceInfo> result = new ArrayList<>();
+        BluetoothAdapter adapter = BluetoothAdapter.getDefaultAdapter();
+        
+        if (adapter == null || !adapter.isEnabled()) {
+            return result;
+        }
+
+        // Перевірка дозволів для Android 12+
+        if (Build.VERSION.SDK_INT >= Build.VERSION_CODES.S && 
+            ActivityCompat.checkSelfPermission(context, Manifest.permission.BLUETOOTH_CONNECT) != PackageManager.PERMISSION_GRANTED) {
+            return result;
+        }
+
+        Set<BluetoothDevice> paired = adapter.getBondedDevices();
+        if (paired != null) {
+            for (BluetoothDevice device : paired) {
+                String name = device.getName();
+                String address = device.getAddress();
+                if (address != null && !address.isEmpty()) {
+                    result.add(new BluetoothDeviceInfo(address, name != null ? name : ""));
+                }
+            }
+        }
+        return result;
+    }
+
+    /**
+     * Відправляє ZPL код на принтер.
+     * 
+     * @param address MAC-адреса принтера.
+     * @param port Порт (зарезервовано для майбутнього використання).
+     * @param zpl Текст у форматі ZPL.
+     */
+    public void printZpl(Context context, String address, int port, String zpl, PrintCallback callback) {
+        final String addrTrimmed = address != null ? address.trim() : "";
+        
+        if (addrTrimmed.isEmpty()) {
+            callback.onError("ADDRESS_MISSING", new IllegalArgumentException("Адреса принтера не вказана."));
+            return;
+        }
+
+        executor.execute(() -> {
+            BluetoothSocket socket = null;
+            OutputStream out = null;
+            try {
+                BluetoothAdapter adapter = BluetoothAdapter.getDefaultAdapter();
+                
+                // Перевірка доступності Bluetooth
+                if (adapter == null || !adapter.isEnabled()) {
+                    callback.onError("BLUETOOTH_DISABLED", new IllegalStateException("Bluetooth вимкнено або не підтримується."));
+                    return;
+                }
+
+                BluetoothDevice device = adapter.getRemoteDevice(addrTrimmed);
+                
+                // Спроба підключення через стандартний SPP UUID
+                try {
+                    socket = device.createRfcommSocketToServiceRecord(SPP_UUID);
+                    socket.connect();
+                } catch (IOException e) {
+                    // Резервний метод підключення для деяких моделей принтерів
+                    Logger.info("Zebra", "Помилка SPP, спроба через RFCOMM канал 1");
+                    if (socket != null) socket.close();
+                    socket = (BluetoothSocket) device.getClass()
+                            .getMethod("createRfcommSocket", int.class)
+                            .invoke(device, 1);
+                    socket.connect();
+                }
+
+                out = socket.getOutputStream();
+                byte[] data = zpl.getBytes(StandardCharsets.UTF_8);
+                out.write(data);
+                out.flush();
+
+                Logger.info("Zebra", "ZPL успішно відправлено: " + data.length + " байт");
+                callback.onSuccess(addrTrimmed, data.length);
+                
+            } catch (Exception e) {
+                Logger.error("Zebra", "Помилка друку: " + e.getMessage(), e);
+                callback.onError("PRINT_ERROR", e);
+            } finally {
+                // Закриття потоків та сокета
+                try {
+                    if (out != null) out.close();
+                    if (socket != null) socket.close();
+                } catch (IOException ignored) {}
+            }
+        });
+    }
+
+    /**
+     * Модель даних для інформації про Bluetooth пристрій.
+     */
+    public static class BluetoothDeviceInfo {
+        public final String address;
+        public final String name;
+
+        public BluetoothDeviceInfo(String address, String name) {
+            this.address = address;
+            this.name = name;
+        }
+    }
+
+    /**
+     * Інтерфейс для зворотного зв'язку про результат операції друку.
+     */
+    public interface PrintCallback {
+        void onSuccess(String address, int bytesSent);
+        void onError(String code, Throwable error);
     }
 }

package/android/src/main/java/dev/nitra/zebra/ZebraPlugin.java

@@ -1,22 +1,158 @@
 package dev.nitra.zebra;
 
+import android.Manifest;
 import com.getcapacitor.JSObject;
+import com.getcapacitor.PermissionState;
 import com.getcapacitor.Plugin;
 import com.getcapacitor.PluginCall;
 import com.getcapacitor.PluginMethod;
 import com.getcapacitor.annotation.CapacitorPlugin;
+import com.getcapacitor.annotation.Permission;
+import com.getcapacitor.annotation.PermissionCallback;
 
-@CapacitorPlugin(name = "Zebra")
+import org.json.JSONArray;
+import org.json.JSONObject;
+
+import java.util.List;
+
+/**
+ * ZebraPlugin — Capacitor плагін для роботи з принтерами Zebra.
+ * Дозволяє шукати пристрої, встановлювати адресу та друкувати ZPL команди.
+ */
+@CapacitorPlugin(
+    name = "Zebra",
+    permissions = {
+        @Permission(
+            strings = { Manifest.permission.BLUETOOTH_CONNECT },
+            alias = "bt_connect"
+        )
+    }
+)
 public class ZebraPlugin extends Plugin {
 
-    private Zebra implementation = new Zebra();
+    // Екземпляр класу з логікою реалізації взаємодії з принтером
+    private final Zebra implementation = new Zebra();
+
+    /**
+     * Встановлює адресу принтера (Bluetooth MAC-адресу).
+     */
+    @PluginMethod
+    public void setPrinterAddress(PluginCall call) {
+        String address = call.getString("address");
+        Integer port = call.getInt("port", 0);
+
+        // Перевірка наявності адреси
+        if (address == null || address.trim().isEmpty()) {
+            call.reject("Параметр 'address' обов'язковий (Bluetooth MAC-адреса принтера).");
+            return;
+        }
+
+        // Збереження адреси в реалізації
+        implementation.setPrinterAddress(getContext(), address.trim(), port != null ? port : 0);
+        
+        JSObject ret = new JSObject();
+        ret.put("address", address.trim());
+        call.resolve(ret);
+    }
 
+    /**
+     * Отримує список підключених (paired) Bluetooth пристроїв.
+     * Спочатку перевіряє дозволи на роботу з Bluetooth.
+     */
     @PluginMethod
-    public void echo(PluginCall call) {
-        String value = call.getString("value");
+    public void getPairedDevices(PluginCall call) {
+        if (getPermissionState("bt_connect") != PermissionState.GRANTED) {
+            // Запит дозволу, якщо він не наданий
+            requestPermissionForAlias("bt_connect", call, "getPairedDevicesCallback");
+        } else {
+            loadPairedDevices(call);
+        }
+    }
+
+    /**
+     * Callback, який викликається після відповіді користувача на запит дозволу.
+     */
+    @PermissionCallback
+    private void getPairedDevicesCallback(PluginCall call) {
+        if (getPermissionState("bt_connect") != PermissionState.GRANTED) {
+            call.reject("Дозвіл необхідний для доступу до Bluetooth пристроїв.");
+            return;
+        }
+        loadPairedDevices(call);
+    }
 
+    /**
+     * Внутрішній метод для завантаження списку пристроїв та відправки результату в JS.
+     */
+    void loadPairedDevices(PluginCall call) {
+        List<Zebra.BluetoothDeviceInfo> devices = implementation.getPairedDevices(getContext());
+        JSONArray arr = new JSONArray();
+        for (Zebra.BluetoothDeviceInfo d : devices) {
+            JSONObject o = new JSONObject();
+            try {
+                o.put("address", d.address);
+                o.put("name", d.name);
+            } catch (Exception ignored) {
+            }
+            arr.put(o);
+        }
         JSObject ret = new JSObject();
-        ret.put("value", implementation.echo(value));
+        ret.put("devices", arr);
         call.resolve(ret);
     }
+
+    /**
+     * Метод для друку ZPL коду.
+     * Підтримує параметри: { zpl, address?, port? }
+     */
+    @PluginMethod
+    public void print(PluginCall call) {
+        String zpl = call.getString("zpl");
+        String address = call.getString("address");
+        Integer port = call.getInt("port", 0);
+
+        // Виклик методу друку в основній реалізації
+        implementation.printZpl(
+                getContext(),
+                address,
+                port != null ? port : 0,
+                zpl != null ? zpl : "",
+                new Zebra.PrintCallback() {
+                    @Override
+                    public void onSuccess(String address, int bytesSent) {
+                        // Повернення успішного результату в JS на головному потоці
+                        runOnMainThread(() -> {
+                            JSObject ret = new JSObject();
+                            ret.put("success", true);
+                            ret.put("address", address);
+                            ret.put("bytesSent", bytesSent);
+                            call.resolve(ret);
+                        });
+                    }
+
+                    @Override
+                    public void onError(String code, Throwable error) {
+                        // Повернення помилки в JS
+                        runOnMainThread(() -> {
+                            JSObject ret = new JSObject();
+                            ret.put("success", false);
+                            ret.put("code", code);
+                            ret.put("message", error.getMessage());
+                            call.reject(error.getMessage(), code, new Exception(error), ret);
+                        });
+                    }
+                }
+        );
+    }
+
+    /**
+     * Допоміжний метод для виконання коду на UI-потоці.
+     */
+    private void runOnMainThread(Runnable runnable) {
+        if (getActivity() != null) {
+            getActivity().runOnUiThread(runnable);
+        } else {
+            runnable.run();
+        }
+    }
 }

package/dist/index.d.ts

@@ -0,0 +1,35 @@
+//#region src/index.d.ts
+type PairedDevice = {
+  address: string;
+  name: string;
+};
+type PrintResult = {
+  success?: boolean;
+  devices?: PairedDevice[];
+  message?: string;
+};
+interface ZebraPlugin {
+  print(options: {
+    zpl: string;
+    address: string;
+  }): Promise<PrintResult>;
+  setPrinterAddress(options: {
+    address: string;
+    port?: number;
+  }): Promise<{
+    address: string;
+  }>;
+  getPairedDevices(): Promise<{
+    devices: PairedDevice[];
+  }>;
+}
+interface Zebra {
+  /** Приймає лише zpl як рядок; address береться з Preferences на нативних платформах. */
+  print(zpl: string): Promise<PrintResult>;
+  getPairedDevices(): Promise<{
+    devices: PairedDevice[];
+  }>;
+}
+declare const Zebra: Zebra;
+//#endregion
+export { PairedDevice, PrintResult, Zebra, ZebraPlugin };