first commit

This commit is contained in:
unknown 2026-03-18 09:43:44 +05:30
commit 26d310b278
36 changed files with 6467 additions and 0 deletions

3
.eslintignore Normal file
View File

@ -0,0 +1,3 @@
build
dist
example-app

70
.gitignore vendored Normal file
View File

@ -0,0 +1,70 @@
# node files
dist
node_modules
# iOS files
Pods
Podfile.lock
Package.resolved
Build
xcuserdata
/.build
/Packages
xcuserdata/
DerivedData/
.swiftpm/configuration/registries.json
.swiftpm/xcode/package.xcworkspace/contents.xcworkspacedata
.netrc
# macOS files
.DS_Store
# Based on Android gitignore template: https://github.com/github/gitignore/blob/HEAD/Android.gitignore
# Built application files
*.apk
*.ap_
# Files for the ART/Dalvik VM
*.dex
# Java class files
*.class
# Generated files
bin
gen
out
# Gradle files
.gradle
build
# Local configuration file (sdk path, etc)
local.properties
# Proguard folder generated by Eclipse
proguard
# Log Files
*.log
# Android Studio Navigation editor temp files
.navigation
# Android Studio captures folder
captures
# IntelliJ
*.iml
.idea
# Keystore files
# Uncomment the following line if you do not want to check your keystore files in.
#*.jks
# External native build folder generated in Android Studio 2.2 and later
.externalNativeBuild

1
.prettierignore Normal file
View File

@ -0,0 +1 @@
example-app

52
CONTRIBUTING.md Normal file
View File

@ -0,0 +1,52 @@
# Contributing
This guide provides instructions for contributing to this Capacitor plugin.
## Developing
### Local Setup
1. Fork and clone the repo.
1. Install the dependencies.
```shell
npm install
```
1. Install SwiftLint if you're on macOS.
```shell
brew install swiftlint
```
### Scripts
#### `npm run build`
Build the plugin web assets and generate plugin API documentation using [`@capacitor/docgen`](https://github.com/ionic-team/capacitor-docgen).
It will compile the TypeScript code from `src/` into ESM JavaScript in `dist/esm/`. These files are used in apps with bundlers when your plugin is imported.
Then, Rollup will bundle the code into a single file at `dist/plugin.js`. This file is used in apps without bundlers by including it as a script in `index.html`.
#### `npm run verify`
Build and validate the web and native projects.
This is useful to run in CI to verify that the plugin builds for all platforms.
#### `npm run lint` / `npm run fmt`
Check formatting and code quality, autoformat/autofix if possible.
This template is integrated with ESLint, Prettier, and SwiftLint. Using these tools is completely optional, but the [Capacitor Community](https://github.com/capacitor-community/) strives to have consistent code style and structure for easier cooperation.
## Publishing
There is a `prepublishOnly` hook in `package.json` which prepares the plugin before publishing, so all you need to do is run:
```shell
npm publish
```
> **Note**: The [`files`](https://docs.npmjs.com/cli/v7/configuring-npm/package-json#files) array in `package.json` specifies which files get published. If you rename files/directories or add files elsewhere, you may need to update it.

View File

@ -0,0 +1,17 @@
require 'json'
package = JSON.parse(File.read(File.join(__dir__, 'package.json')))
Pod::Spec.new do |s|
s.name = 'CapacitorPozoPrinter'
s.version = package['version']
s.summary = package['description']
s.license = package['license']
s.homepage = package['repository']['url']
s.author = package['author']
s.source = { :git => package['repository']['url'], :tag => s.version.to_s }
s.source_files = 'ios/Sources/**/*.{swift,h,m,c,cc,mm,cpp}'
s.ios.deployment_target = '15.0'
s.dependency 'Capacitor'
s.swift_version = '5.1'
end

28
Package.swift Normal file
View File

@ -0,0 +1,28 @@
// swift-tools-version: 5.9
import PackageDescription
let package = Package(
name: "CapacitorPozoPrinter",
platforms: [.iOS(.v15)],
products: [
.library(
name: "CapacitorPozoPrinter",
targets: ["PrinterPlugin"])
],
dependencies: [
.package(url: "https://github.com/ionic-team/capacitor-swift-pm.git", from: "8.0.0")
],
targets: [
.target(
name: "PrinterPlugin",
dependencies: [
.product(name: "Capacitor", package: "capacitor-swift-pm"),
.product(name: "Cordova", package: "capacitor-swift-pm")
],
path: "ios/Sources/PrinterPlugin"),
.testTarget(
name: "PrinterPluginTests",
dependencies: ["PrinterPlugin"],
path: "ios/Tests/PrinterPluginTests")
]
)

173
README.md Normal file
View File

@ -0,0 +1,173 @@
# capacitor-pozo-printer
Capacitor plugin for Pozo Retail thermal printer integration (USB / ESC POS)
## Install
To use npm
```bash
npm install capacitor-pozo-printer
````
To use yarn
```bash
yarn add capacitor-pozo-printer
```
Sync native files
```bash
npx cap sync
```
## API
<docgen-index>
* [`requestPermissions()`](#requestpermissions)
* [`scanBluetooth()`](#scanbluetooth)
* [`scanUsb()`](#scanusb)
* [`printBluetooth(...)`](#printbluetooth)
* [`printNetwork(...)`](#printnetwork)
* [`printUsb(...)`](#printusb)
* [Interfaces](#interfaces)
</docgen-index>
<docgen-api>
<!--Update the source file JSDoc comments and rerun docgen to update the docs below-->
### requestPermissions()
```typescript
requestPermissions() => Promise<PermissionResult>
```
**Returns:** <code>Promise&lt;<a href="#permissionresult">PermissionResult</a>&gt;</code>
--------------------
### scanBluetooth()
```typescript
scanBluetooth() => Promise<{ devices: PrinterDevice[]; }>
```
Scan paired Bluetooth devices
**Returns:** <code>Promise&lt;{ devices: PrinterDevice[]; }&gt;</code>
--------------------
### scanUsb()
```typescript
scanUsb() => Promise<{ devices: PrinterDevice[]; }>
```
Scan connected USB devices
**Returns:** <code>Promise&lt;{ devices: PrinterDevice[]; }&gt;</code>
--------------------
### printBluetooth(...)
```typescript
printBluetooth(options: BluetoothPrintOptions) => Promise<{ success: boolean; }>
```
Print via Bluetooth SPP
| Param | Type |
| ------------- | ----------------------------------------------------------------------- |
| **`options`** | <code><a href="#bluetoothprintoptions">BluetoothPrintOptions</a></code> |
**Returns:** <code>Promise&lt;{ success: boolean; }&gt;</code>
--------------------
### printNetwork(...)
```typescript
printNetwork(options: NetworkPrintOptions) => Promise<{ success: boolean; }>
```
Print via Network/LAN/WiFi (TCP port 9100)
| Param | Type |
| ------------- | ------------------------------------------------------------------- |
| **`options`** | <code><a href="#networkprintoptions">NetworkPrintOptions</a></code> |
**Returns:** <code>Promise&lt;{ success: boolean; }&gt;</code>
--------------------
### printUsb(...)
```typescript
printUsb(options: UsbPrintOptions) => Promise<{ success: boolean; }>
```
Print via USB OTG
| Param | Type |
| ------------- | ----------------------------------------------------------- |
| **`options`** | <code><a href="#usbprintoptions">UsbPrintOptions</a></code> |
**Returns:** <code>Promise&lt;{ success: boolean; }&gt;</code>
--------------------
### Interfaces
#### PermissionResult
| Prop | Type |
| --------------- | ---------------------------------------------- |
| **`bluetooth`** | <code>'granted' \| 'denied' \| 'prompt'</code> |
| **`network`** | <code>'granted' \| 'denied' \| 'prompt'</code> |
#### PrinterDevice
| Prop | Type |
| ------------- | ------------------- |
| **`name`** | <code>string</code> |
| **`address`** | <code>string</code> |
#### BluetoothPrintOptions
| Prop | Type |
| ------------- | --------------------- |
| **`address`** | <code>string</code> |
| **`data`** | <code>number[]</code> |
#### NetworkPrintOptions
| Prop | Type |
| ---------- | --------------------- |
| **`host`** | <code>string</code> |
| **`port`** | <code>number</code> |
| **`data`** | <code>number[]</code> |
#### UsbPrintOptions
| Prop | Type |
| -------------- | --------------------- |
| **`data`** | <code>number[]</code> |
| **`deviceId`** | <code>string</code> |
</docgen-api>

1
android/.gitignore vendored Normal file
View File

@ -0,0 +1 @@
/build

59
android/build.gradle Normal file
View File

@ -0,0 +1,59 @@
ext {
junitVersion = project.hasProperty('junitVersion') ? rootProject.ext.junitVersion : '4.13.2'
androidxAppCompatVersion = project.hasProperty('androidxAppCompatVersion') ? rootProject.ext.androidxAppCompatVersion : '1.7.1'
androidxJunitVersion = project.hasProperty('androidxJunitVersion') ? rootProject.ext.androidxJunitVersion : '1.3.0'
androidxEspressoCoreVersion = project.hasProperty('androidxEspressoCoreVersion') ? rootProject.ext.androidxEspressoCoreVersion : '3.7.0'
}
buildscript {
repositories {
google()
mavenCentral()
}
dependencies {
classpath 'com.android.tools.build:gradle:8.13.0'
}
}
apply plugin: 'com.android.library'
android {
namespace = "com.pozo.printer"
compileSdk = project.hasProperty('compileSdkVersion') ? rootProject.ext.compileSdkVersion : 36
defaultConfig {
minSdkVersion project.hasProperty('minSdkVersion') ? rootProject.ext.minSdkVersion : 24
targetSdkVersion project.hasProperty('targetSdkVersion') ? rootProject.ext.targetSdkVersion : 36
versionCode 1
versionName "1.0"
testInstrumentationRunner "androidx.test.runner.AndroidJUnitRunner"
}
buildTypes {
release {
minifyEnabled false
proguardFiles getDefaultProguardFile('proguard-android-optimize.txt'), 'proguard-rules.pro'
}
}
lintOptions {
abortOnError = false
}
compileOptions {
sourceCompatibility JavaVersion.VERSION_21
targetCompatibility JavaVersion.VERSION_21
}
}
repositories {
google()
mavenCentral()
}
dependencies {
implementation fileTree(dir: 'libs', include: ['*.jar'])
implementation project(':capacitor-android')
implementation "androidx.appcompat:appcompat:$androidxAppCompatVersion"
testImplementation "junit:junit:$junitVersion"
androidTestImplementation "androidx.test.ext:junit:$androidxJunitVersion"
androidTestImplementation "androidx.test.espresso:espresso-core:$androidxEspressoCoreVersion"
}

22
android/gradle.properties Normal file
View File

@ -0,0 +1,22 @@
# Project-wide Gradle settings.
# IDE (e.g. Android Studio) users:
# Gradle settings configured through the IDE *will override*
# any settings specified in this file.
# For more details on how to configure your build environment visit
# http://www.gradle.org/docs/current/userguide/build_environment.html
# Specifies the JVM arguments used for the daemon process.
# The setting is particularly useful for tweaking memory settings.
org.gradle.jvmargs=-Xmx1536m
# When configured, Gradle will run in incubating parallel mode.
# This option should only be used with decoupled projects. More details, visit
# http://www.gradle.org/docs/current/userguide/multi_project_builds.html#sec:decoupled_projects
# org.gradle.parallel=true
# AndroidX package structure to make it clearer which packages are bundled with the
# Android operating system, and which are packaged with your app's APK
# https://developer.android.com/topic/libraries/support-library/androidx-rn
android.useAndroidX=true

Binary file not shown.

View File

@ -0,0 +1,7 @@
distributionBase=GRADLE_USER_HOME
distributionPath=wrapper/dists
distributionUrl=https\://services.gradle.org/distributions/gradle-8.14.3-all.zip
networkTimeout=10000
validateDistributionUrl=true
zipStoreBase=GRADLE_USER_HOME
zipStorePath=wrapper/dists

251
android/gradlew vendored Normal file
View File

@ -0,0 +1,251 @@
#!/bin/sh
#
# Copyright © 2015-2021 the original authors.
#
# Licensed under the Apache License, Version 2.0 (the "License");
# you may not use this file except in compliance with the License.
# You may obtain a copy of the License at
#
# https://www.apache.org/licenses/LICENSE-2.0
#
# Unless required by applicable law or agreed to in writing, software
# distributed under the License is distributed on an "AS IS" BASIS,
# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
# See the License for the specific language governing permissions and
# limitations under the License.
#
# SPDX-License-Identifier: Apache-2.0
#
##############################################################################
#
# Gradle start up script for POSIX generated by Gradle.
#
# Important for running:
#
# (1) You need a POSIX-compliant shell to run this script. If your /bin/sh is
# noncompliant, but you have some other compliant shell such as ksh or
# bash, then to run this script, type that shell name before the whole
# command line, like:
#
# ksh Gradle
#
# Busybox and similar reduced shells will NOT work, because this script
# requires all of these POSIX shell features:
# * functions;
# * expansions «$var», «${var}», «${var:-default}», «${var+SET}»,
# «${var#prefix}», «${var%suffix}», and «$( cmd )»;
# * compound commands having a testable exit status, especially «case»;
# * various built-in commands including «command», «set», and «ulimit».
#
# Important for patching:
#
# (2) This script targets any POSIX shell, so it avoids extensions provided
# by Bash, Ksh, etc; in particular arrays are avoided.
#
# The "traditional" practice of packing multiple parameters into a
# space-separated string is a well documented source of bugs and security
# problems, so this is (mostly) avoided, by progressively accumulating
# options in "$@", and eventually passing that to Java.
#
# Where the inherited environment variables (DEFAULT_JVM_OPTS, JAVA_OPTS,
# and GRADLE_OPTS) rely on word-splitting, this is performed explicitly;
# see the in-line comments for details.
#
# There are tweaks for specific operating systems such as AIX, CygWin,
# Darwin, MinGW, and NonStop.
#
# (3) This script is generated from the Groovy template
# https://github.com/gradle/gradle/blob/HEAD/platforms/jvm/plugins-application/src/main/resources/org/gradle/api/internal/plugins/unixStartScript.txt
# within the Gradle project.
#
# You can find Gradle at https://github.com/gradle/gradle/.
#
##############################################################################
# Attempt to set APP_HOME
# Resolve links: $0 may be a link
app_path=$0
# Need this for daisy-chained symlinks.
while
APP_HOME=${app_path%"${app_path##*/}"} # leaves a trailing /; empty if no leading path
[ -h "$app_path" ]
do
ls=$( ls -ld "$app_path" )
link=${ls#*' -> '}
case $link in #(
/*) app_path=$link ;; #(
*) app_path=$APP_HOME$link ;;
esac
done
# This is normally unused
# shellcheck disable=SC2034
APP_BASE_NAME=${0##*/}
# Discard cd standard output in case $CDPATH is set (https://github.com/gradle/gradle/issues/25036)
APP_HOME=$( cd -P "${APP_HOME:-./}" > /dev/null && printf '%s\n' "$PWD" ) || exit
# Use the maximum available, or set MAX_FD != -1 to use that value.
MAX_FD=maximum
warn () {
echo "$*"
} >&2
die () {
echo
echo "$*"
echo
exit 1
} >&2
# OS specific support (must be 'true' or 'false').
cygwin=false
msys=false
darwin=false
nonstop=false
case "$( uname )" in #(
CYGWIN* ) cygwin=true ;; #(
Darwin* ) darwin=true ;; #(
MSYS* | MINGW* ) msys=true ;; #(
NONSTOP* ) nonstop=true ;;
esac
CLASSPATH="\\\"\\\""
# Determine the Java command to use to start the JVM.
if [ -n "$JAVA_HOME" ] ; then
if [ -x "$JAVA_HOME/jre/sh/java" ] ; then
# IBM's JDK on AIX uses strange locations for the executables
JAVACMD=$JAVA_HOME/jre/sh/java
else
JAVACMD=$JAVA_HOME/bin/java
fi
if [ ! -x "$JAVACMD" ] ; then
die "ERROR: JAVA_HOME is set to an invalid directory: $JAVA_HOME
Please set the JAVA_HOME variable in your environment to match the
location of your Java installation."
fi
else
JAVACMD=java
if ! command -v java >/dev/null 2>&1
then
die "ERROR: JAVA_HOME is not set and no 'java' command could be found in your PATH.
Please set the JAVA_HOME variable in your environment to match the
location of your Java installation."
fi
fi
# Increase the maximum file descriptors if we can.
if ! "$cygwin" && ! "$darwin" && ! "$nonstop" ; then
case $MAX_FD in #(
max*)
# In POSIX sh, ulimit -H is undefined. That's why the result is checked to see if it worked.
# shellcheck disable=SC2039,SC3045
MAX_FD=$( ulimit -H -n ) ||
warn "Could not query maximum file descriptor limit"
esac
case $MAX_FD in #(
'' | soft) :;; #(
*)
# In POSIX sh, ulimit -n is undefined. That's why the result is checked to see if it worked.
# shellcheck disable=SC2039,SC3045
ulimit -n "$MAX_FD" ||
warn "Could not set maximum file descriptor limit to $MAX_FD"
esac
fi
# Collect all arguments for the java command, stacking in reverse order:
# * args from the command line
# * the main class name
# * -classpath
# * -D...appname settings
# * --module-path (only if needed)
# * DEFAULT_JVM_OPTS, JAVA_OPTS, and GRADLE_OPTS environment variables.
# For Cygwin or MSYS, switch paths to Windows format before running java
if "$cygwin" || "$msys" ; then
APP_HOME=$( cygpath --path --mixed "$APP_HOME" )
CLASSPATH=$( cygpath --path --mixed "$CLASSPATH" )
JAVACMD=$( cygpath --unix "$JAVACMD" )
# Now convert the arguments - kludge to limit ourselves to /bin/sh
for arg do
if
case $arg in #(
-*) false ;; # don't mess with options #(
/?*) t=${arg#/} t=/${t%%/*} # looks like a POSIX filepath
[ -e "$t" ] ;; #(
*) false ;;
esac
then
arg=$( cygpath --path --ignore --mixed "$arg" )
fi
# Roll the args list around exactly as many times as the number of
# args, so each arg winds up back in the position where it started, but
# possibly modified.
#
# NB: a `for` loop captures its iteration list before it begins, so
# changing the positional parameters here affects neither the number of
# iterations, nor the values presented in `arg`.
shift # remove old arg
set -- "$@" "$arg" # push replacement arg
done
fi
# Add default JVM options here. You can also use JAVA_OPTS and GRADLE_OPTS to pass JVM options to this script.
DEFAULT_JVM_OPTS='"-Xmx64m" "-Xms64m"'
# Collect all arguments for the java command:
# * DEFAULT_JVM_OPTS, JAVA_OPTS, and optsEnvironmentVar are not allowed to contain shell fragments,
# and any embedded shellness will be escaped.
# * For example: A user cannot expect ${Hostname} to be expanded, as it is an environment variable and will be
# treated as '${Hostname}' itself on the command line.
set -- \
"-Dorg.gradle.appname=$APP_BASE_NAME" \
-classpath "$CLASSPATH" \
-jar "$APP_HOME/gradle/wrapper/gradle-wrapper.jar" \
"$@"
# Stop when "xargs" is not available.
if ! command -v xargs >/dev/null 2>&1
then
die "xargs is not available"
fi
# Use "xargs" to parse quoted args.
#
# With -n1 it outputs one arg per line, with the quotes and backslashes removed.
#
# In Bash we could simply go:
#
# readarray ARGS < <( xargs -n1 <<<"$var" ) &&
# set -- "${ARGS[@]}" "$@"
#
# but POSIX shell has neither arrays nor command substitution, so instead we
# post-process each arg (as a line of input to sed) to backslash-escape any
# character that might be a shell metacharacter, then use eval to reverse
# that process (while maintaining the separation between arguments), and wrap
# the whole thing up as a single "set" statement.
#
# This will of course break if any of these variables contains a newline or
# an unmatched quote.
#
eval "set -- $(
printf '%s\n' "$DEFAULT_JVM_OPTS $JAVA_OPTS $GRADLE_OPTS" |
xargs -n1 |
sed ' s~[^-[:alnum:]+,./:=@_]~\\&~g; ' |
tr '\n' ' '
)" '"$@"'
exec "$JAVACMD" "$@"

94
android/gradlew.bat vendored Normal file
View File

@ -0,0 +1,94 @@
@rem
@rem Copyright 2015 the original author or authors.
@rem
@rem Licensed under the Apache License, Version 2.0 (the "License");
@rem you may not use this file except in compliance with the License.
@rem You may obtain a copy of the License at
@rem
@rem https://www.apache.org/licenses/LICENSE-2.0
@rem
@rem Unless required by applicable law or agreed to in writing, software
@rem distributed under the License is distributed on an "AS IS" BASIS,
@rem WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
@rem See the License for the specific language governing permissions and
@rem limitations under the License.
@rem
@rem SPDX-License-Identifier: Apache-2.0
@rem
@if "%DEBUG%"=="" @echo off
@rem ##########################################################################
@rem
@rem Gradle startup script for Windows
@rem
@rem ##########################################################################
@rem Set local scope for the variables with windows NT shell
if "%OS%"=="Windows_NT" setlocal
set DIRNAME=%~dp0
if "%DIRNAME%"=="" set DIRNAME=.
@rem This is normally unused
set APP_BASE_NAME=%~n0
set APP_HOME=%DIRNAME%
@rem Resolve any "." and ".." in APP_HOME to make it shorter.
for %%i in ("%APP_HOME%") do set APP_HOME=%%~fi
@rem Add default JVM options here. You can also use JAVA_OPTS and GRADLE_OPTS to pass JVM options to this script.
set DEFAULT_JVM_OPTS="-Xmx64m" "-Xms64m"
@rem Find java.exe
if defined JAVA_HOME goto findJavaFromJavaHome
set JAVA_EXE=java.exe
%JAVA_EXE% -version >NUL 2>&1
if %ERRORLEVEL% equ 0 goto execute
echo. 1>&2
echo ERROR: JAVA_HOME is not set and no 'java' command could be found in your PATH. 1>&2
echo. 1>&2
echo Please set the JAVA_HOME variable in your environment to match the 1>&2
echo location of your Java installation. 1>&2
goto fail
:findJavaFromJavaHome
set JAVA_HOME=%JAVA_HOME:"=%
set JAVA_EXE=%JAVA_HOME%/bin/java.exe
if exist "%JAVA_EXE%" goto execute
echo. 1>&2
echo ERROR: JAVA_HOME is set to an invalid directory: %JAVA_HOME% 1>&2
echo. 1>&2
echo Please set the JAVA_HOME variable in your environment to match the 1>&2
echo location of your Java installation. 1>&2
goto fail
:execute
@rem Setup the command line
set CLASSPATH=
@rem Execute Gradle
"%JAVA_EXE%" %DEFAULT_JVM_OPTS% %JAVA_OPTS% %GRADLE_OPTS% "-Dorg.gradle.appname=%APP_BASE_NAME%" -classpath "%CLASSPATH%" -jar "%APP_HOME%\gradle\wrapper\gradle-wrapper.jar" %*
:end
@rem End local scope for the variables with windows NT shell
if %ERRORLEVEL% equ 0 goto mainEnd
:fail
rem Set variable GRADLE_EXIT_CONSOLE if you need the _script_ return code instead of
rem the _cmd.exe /c_ return code!
set EXIT_CODE=%ERRORLEVEL%
if %EXIT_CODE% equ 0 set EXIT_CODE=1
if not ""=="%GRADLE_EXIT_CONSOLE%" exit %EXIT_CODE%
exit /b %EXIT_CODE%
:mainEnd
if "%OS%"=="Windows_NT" endlocal
:omega

21
android/proguard-rules.pro vendored Normal file
View File

@ -0,0 +1,21 @@
# Add project specific ProGuard rules here.
# You can control the set of applied configuration files using the
# proguardFiles setting in build.gradle.
#
# For more details, see
# http://developer.android.com/guide/developing/tools/proguard.html
# If your project uses WebView with JS, uncomment the following
# and specify the fully qualified class name to the JavaScript interface
# class:
#-keepclassmembers class fqcn.of.javascript.interface.for.webview {
# public *;
#}
# Uncomment this to preserve the line number information for
# debugging stack traces.
#-keepattributes SourceFile,LineNumberTable
# If you keep the line number information, uncomment this to
# hide the original source file name.
#-renamesourcefileattribute SourceFile

2
android/settings.gradle Normal file
View File

@ -0,0 +1,2 @@
include ':capacitor-android'
project(':capacitor-android').projectDir = new File('../node_modules/@capacitor/android/capacitor')

View File

@ -0,0 +1,26 @@
package com.getcapacitor.android;
import static org.junit.Assert.*;
import android.content.Context;
import androidx.test.ext.junit.runners.AndroidJUnit4;
import androidx.test.platform.app.InstrumentationRegistry;
import org.junit.Test;
import org.junit.runner.RunWith;
/**
* Instrumented test, which will execute on an Android device.
*
* @see <a href="http://d.android.com/tools/testing">Testing documentation</a>
*/
@RunWith(AndroidJUnit4.class)
public class ExampleInstrumentedTest {
@Test
public void useAppContext() throws Exception {
// Context of the app under test.
Context appContext = InstrumentationRegistry.getInstrumentation().getTargetContext();
assertEquals("com.getcapacitor.android", appContext.getPackageName());
}
}

View File

@ -0,0 +1,14 @@
<manifest xmlns:android="http://schemas.android.com/apk/res/android">
<!-- Bluetooth Classic (for thermal printers) -->
<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"/>
<uses-permission android:name="android.permission.BLUETOOTH_SCAN"/>
<!-- Network -->
<uses-permission android:name="android.permission.INTERNET"/>
<uses-permission android:name="android.permission.ACCESS_NETWORK_STATE"/>
<!-- USB OTG -->
<uses-feature android:name="android.hardware.usb.host" android:required="false"/>
</manifest>

View File

@ -0,0 +1,84 @@
package com.pozo.printer;
import android.bluetooth.BluetoothAdapter;
import android.bluetooth.BluetoothDevice;
import android.bluetooth.BluetoothSocket;
import android.content.Context;
import com.getcapacitor.JSObject;
import java.io.OutputStream;
import java.util.ArrayList;
import java.util.List;
import java.util.Set;
import java.util.UUID;
public class BluetoothPrinter {
private static final UUID SPP_UUID =
UUID.fromString("00001101-0000-1000-8000-00805F9B34FB");
public static List<JSObject> scanDevices(Context context) {
List<JSObject> result = new ArrayList<>();
BluetoothAdapter adapter = BluetoothAdapter.getDefaultAdapter();
if (adapter == null || !adapter.isEnabled()) return result;
Set<BluetoothDevice> paired = adapter.getBondedDevices();
for (BluetoothDevice device : paired) {
JSObject obj = new JSObject();
obj.put("name", device.getName() != null ? device.getName() : "Unknown");
obj.put("address", device.getAddress());
result.add(obj);
}
return result;
}
public static void print(String address, byte[] data) throws Exception {
BluetoothAdapter adapter = BluetoothAdapter.getDefaultAdapter();
if (adapter == null || !adapter.isEnabled()) {
throw new Exception("Bluetooth is not available or not enabled");
}
BluetoothDevice device = adapter.getRemoteDevice(address);
adapter.cancelDiscovery();
// Retry up to 3 times
int maxRetries = 3;
int attempt = 0;
Exception lastError = null;
while (attempt < maxRetries) {
BluetoothSocket socket = null;
try {
socket = device.createRfcommSocketToServiceRecord(SPP_UUID);
socket.connect();
OutputStream out = socket.getOutputStream();
int chunkSize = 512;
int offset = 0;
while (offset < data.length) {
int size = Math.min(chunkSize, data.length - offset);
out.write(data, offset, size);
out.flush();
offset += size;
Thread.sleep(10);
}
Thread.sleep(500);
return; // success, exit
} catch (Exception e) {
lastError = e;
attempt++;
if (socket != null) {
try { socket.close(); } catch (Exception ignored) {}
}
if (attempt < maxRetries) {
Thread.sleep(1000); // wait before retry
}
} finally {
if (socket != null) {
try { socket.close(); } catch (Exception ignored) {}
}
}
}
throw new Exception("Failed after " + maxRetries + " attempts: " + lastError.getMessage());
}
}

View File

@ -0,0 +1,19 @@
package com.pozo.printer;
import java.io.OutputStream;
import java.net.Socket;
public class NetworkPrinter {
public static void print(String host, int port, byte[] data) throws Exception {
Socket socket = new Socket(host, port);
socket.setSoTimeout(10000);
try {
OutputStream out = socket.getOutputStream();
out.write(data);
out.flush();
} finally {
socket.close();
}
}
}

View File

@ -0,0 +1,11 @@
package com.pozo.printer;
import com.getcapacitor.Logger;
public class Printer {
public String echo(String value) {
Logger.info("Echo", value);
return value;
}
}

View File

@ -0,0 +1,207 @@
package com.pozo.printer;
import android.Manifest;
import android.content.pm.PackageManager;
import com.getcapacitor.JSArray;
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;
import java.util.List;
@CapacitorPlugin(
name = "Printer",
permissions = {
@Permission(
strings = {
Manifest.permission.BLUETOOTH,
Manifest.permission.BLUETOOTH_ADMIN,
Manifest.permission.BLUETOOTH_CONNECT,
Manifest.permission.BLUETOOTH_SCAN
},
alias = "bluetooth"
),
@Permission(
strings = {
Manifest.permission.INTERNET,
Manifest.permission.ACCESS_NETWORK_STATE
},
alias = "network"
)
}
)
public class PrinterPlugin extends Plugin {
// Request Permissions
@PluginMethod
public void requestPermissions(PluginCall call) {
requestAllPermissions(call, "permissionsCallback");
}
@PermissionCallback
private void permissionsCallback(PluginCall call) {
JSObject result = new JSObject();
result.put("bluetooth", getPermissionState("bluetooth").toString().toLowerCase());
result.put("network", getPermissionState("network").toString().toLowerCase());
call.resolve(result);
}
// Bluetooth Scan
@PluginMethod
public void scanBluetooth(PluginCall call) {
if (
android.os.Build.VERSION.SDK_INT >= android.os.Build.VERSION_CODES.S &&
getContext().checkSelfPermission(Manifest.permission.BLUETOOTH_CONNECT)
!= PackageManager.PERMISSION_GRANTED
) {
requestPermissionForAlias("bluetooth", call, "bluetoothScanCallback");
return;
}
performBluetoothScan(call);
}
@PermissionCallback
private void bluetoothScanCallback(PluginCall call) {
if (getPermissionState("bluetooth") == PermissionState.GRANTED) {
performBluetoothScan(call);
} else {
call.reject("Bluetooth permission denied");
}
}
private void performBluetoothScan(PluginCall call) {
try {
List<JSObject> devices = BluetoothPrinter.scanDevices(getContext());
JSObject result = new JSObject();
JSArray arr = new JSArray();
for (JSObject d : devices) arr.put(d);
result.put("devices", arr);
call.resolve(result);
} catch (Exception e) {
call.reject("Bluetooth scan failed: " + e.getMessage());
}
}
// Bluetooth Print
@PluginMethod
public void printBluetooth(PluginCall call) {
if (
android.os.Build.VERSION.SDK_INT >= android.os.Build.VERSION_CODES.S &&
getContext().checkSelfPermission(Manifest.permission.BLUETOOTH_CONNECT)
!= PackageManager.PERMISSION_GRANTED
) {
requestPermissionForAlias("bluetooth", call, "bluetoothPrintCallback");
return;
}
performBluetoothPrint(call);
}
@PermissionCallback
private void bluetoothPrintCallback(PluginCall call) {
if (getPermissionState("bluetooth") == PermissionState.GRANTED) {
performBluetoothPrint(call);
} else {
call.reject("Bluetooth permission denied");
}
}
private void performBluetoothPrint(PluginCall call) {
String address = call.getString("address");
JSArray dataArray = call.getArray("data");
if (address == null || dataArray == null) {
call.reject("Missing address or data");
return;
}
new Thread(() -> {
try {
byte[] data = jsArrayToBytes(dataArray);
BluetoothPrinter.print(address, data);
JSObject result = new JSObject();
result.put("success", true);
call.resolve(result);
} catch (Exception e) {
call.reject("Bluetooth print failed: " + e.getMessage());
}
}).start();
}
// USB Scan
@PluginMethod
public void scanUsb(PluginCall call) {
try {
List<JSObject> devices = UsbPrinter.scanDevices(getContext());
JSObject result = new JSObject();
JSArray arr = new JSArray();
for (JSObject d : devices) arr.put(d);
result.put("devices", arr);
call.resolve(result);
} catch (Exception e) {
call.reject("USB scan failed: " + e.getMessage());
}
}
// USB Print
@PluginMethod
public void printUsb(PluginCall call) {
JSArray dataArray = call.getArray("data");
String deviceId = call.getString("deviceId", null);
if (dataArray == null) {
call.reject("Missing data");
return;
}
new Thread(() -> {
try {
byte[] data = jsArrayToBytes(dataArray);
UsbPrinter.print(getContext(), data, deviceId);
JSObject result = new JSObject();
result.put("success", true);
call.resolve(result);
} catch (Exception e) {
call.reject("USB print failed: " + e.getMessage());
}
}).start();
}
// Network Print
@PluginMethod
public void printNetwork(PluginCall call) {
String host = call.getString("host");
int port = call.getInt("port", 9100);
JSArray dataArray = call.getArray("data");
if (host == null || dataArray == null) {
call.reject("Missing host or data");
return;
}
new Thread(() -> {
try {
byte[] data = jsArrayToBytes(dataArray);
NetworkPrinter.print(host, port, data);
JSObject result = new JSObject();
result.put("success", true);
call.resolve(result);
} catch (Exception e) {
call.reject("Network print failed: " + e.getMessage());
}
}).start();
}
// Helper
private byte[] jsArrayToBytes(JSArray arr) throws Exception {
byte[] bytes = new byte[arr.length()];
for (int i = 0; i < arr.length(); i++) {
bytes[i] = (byte) arr.getInt(i);
}
return bytes;
}
}

View File

@ -0,0 +1,90 @@
package com.pozo.printer;
import android.content.Context;
import android.hardware.usb.*;
import com.getcapacitor.JSObject;
import java.util.ArrayList;
import java.util.HashMap;
import java.util.List;
public class UsbPrinter {
public static List<JSObject> scanDevices(Context context) {
List<JSObject> result = new ArrayList<>();
UsbManager manager =
(UsbManager) context.getSystemService(Context.USB_SERVICE);
if (manager == null) return result;
HashMap<String, UsbDevice> devices = manager.getDeviceList();
for (UsbDevice device : devices.values()) {
JSObject obj = new JSObject();
obj.put(
"name",
device.getProductName() != null ? device.getProductName() : "USB Device"
);
obj.put("address", String.valueOf(device.getDeviceId()));
result.add(obj);
}
return result;
}
public static void print(
Context context,
byte[] data,
String deviceIdStr
) throws Exception {
UsbManager manager =
(UsbManager) context.getSystemService(Context.USB_SERVICE);
if (manager == null) throw new Exception("USB service not available");
HashMap<String, UsbDevice> devices = manager.getDeviceList();
UsbDevice targetDevice = null;
if (deviceIdStr != null) {
int deviceId = Integer.parseInt(deviceIdStr);
for (UsbDevice device : devices.values()) {
if (device.getDeviceId() == deviceId) {
targetDevice = device;
break;
}
}
} else {
if (!devices.isEmpty()) {
targetDevice = devices.values().iterator().next();
}
}
if (targetDevice == null) throw new Exception("USB printer not found");
if (!manager.hasPermission(targetDevice))
throw new Exception("USB permission denied — prompt user first");
UsbInterface intf = targetDevice.getInterface(0);
UsbEndpoint endpoint = null;
for (int i = 0; i < intf.getEndpointCount(); i++) {
UsbEndpoint ep = intf.getEndpoint(i);
if (ep.getDirection() == UsbConstants.USB_DIR_OUT) {
endpoint = ep;
break;
}
}
if (endpoint == null) throw new Exception("No OUT endpoint on USB device");
UsbDeviceConnection connection = manager.openDevice(targetDevice);
if (connection == null) throw new Exception("Cannot open USB device");
connection.claimInterface(intf, true);
try {
int chunkSize = endpoint.getMaxPacketSize();
int offset = 0;
while (offset < data.length) {
int size = Math.min(chunkSize, data.length - offset);
byte[] chunk = new byte[size];
System.arraycopy(data, offset, chunk, 0, size);
connection.bulkTransfer(endpoint, chunk, size, 5000);
offset += size;
}
} finally {
connection.releaseInterface(intf);
connection.close();
}
}
}

View File

View File

@ -0,0 +1,18 @@
package com.getcapacitor;
import static org.junit.Assert.*;
import org.junit.Test;
/**
* Example local unit test, which will execute on the development machine (host).
*
* @see <a href="http://d.android.com/tools/testing">Testing documentation</a>
*/
public class ExampleUnitTest {
@Test
public void addition_isCorrect() throws Exception {
assertEquals(4, 2 + 2);
}
}

8
ios/.gitignore vendored Normal file
View File

@ -0,0 +1,8 @@
.DS_Store
.build
/Packages
xcuserdata/
DerivedData/
.swiftpm/configuration/registries.json
.swiftpm/xcode/package.xcworkspace/contents.xcworkspacedata
.netrc

View File

@ -0,0 +1,8 @@
import Foundation
@objc public class Printer: NSObject {
@objc public func echo(_ value: String) -> String {
print(value)
return value
}
}

View File

@ -0,0 +1,23 @@
import Foundation
import Capacitor
/**
* Please read the Capacitor iOS Plugin Development Guide
* here: https://capacitorjs.com/docs/plugins/ios
*/
@objc(PrinterPlugin)
public class PrinterPlugin: CAPPlugin, CAPBridgedPlugin {
public let identifier = "PrinterPlugin"
public let jsName = "Printer"
public let pluginMethods: [CAPPluginMethod] = [
CAPPluginMethod(name: "echo", returnType: CAPPluginReturnPromise)
]
private let implementation = Printer()
@objc func echo(_ call: CAPPluginCall) {
let value = call.getString("value") ?? ""
call.resolve([
"value": implementation.echo(value)
])
}
}

View File

@ -0,0 +1,15 @@
import XCTest
@testable import PrinterPlugin
class PrinterTests: XCTestCase {
func testEcho() {
// This is an example of a functional test case for a plugin.
// Use XCTAssert and related functions to verify your tests produce the correct results.
let implementation = Printer()
let value = "Hello, World!"
let result = implementation.echo(value)
XCTAssertEqual(value, result)
}
}

4913
package-lock.json generated Normal file

File diff suppressed because it is too large Load Diff

80
package.json Normal file
View File

@ -0,0 +1,80 @@
{
"name": "capacitor-pozo-printer",
"version": "1.0.0",
"description": "Capacitor plugin for Pozo Retail thermal printer integration (USB / ESC POS)",
"main": "dist/plugin.cjs.js",
"module": "dist/esm/index.js",
"types": "dist/esm/index.d.ts",
"unpkg": "dist/plugin.js",
"files": [
"android/src/main/",
"android/build.gradle",
"dist/",
"ios/Sources",
"ios/Tests",
"Package.swift",
"CapacitorPozoPrinter.podspec"
],
"author": "gokul-erusappan",
"license": "MIT",
"repository": {
"type": "git",
"url": "git+http://192.168.1.62:3000/gokul-erusappan/capacitor-pozo-printer.git.git"
},
"bugs": {
"url": "http://192.168.1.62:3000/gokul-erusappan/capacitor-pozo-printer.git/issues"
},
"keywords": [
"capacitor",
"plugin",
"native"
],
"scripts": {
"verify": "npm run verify:ios && npm run verify:android && npm run verify:web",
"verify:ios": "xcodebuild -scheme CapacitorPozoPrinter -destination generic/platform=iOS",
"verify:android": "cd android && ./gradlew clean build test && cd ..",
"verify:web": "npm run build",
"lint": "npm run eslint && npm run prettier -- --check && npm run swiftlint -- lint",
"fmt": "npm run eslint -- --fix && npm run prettier -- --write && npm run swiftlint -- --fix --format",
"eslint": "eslint . --ext ts",
"prettier": "prettier \"**/*.{css,html,ts,js,java}\" --plugin=prettier-plugin-java",
"swiftlint": "node-swiftlint",
"docgen": "docgen --api PrinterPlugin --output-readme README.md --output-json dist/docs.json",
"build": "npm run clean && npm run docgen && tsc && rollup -c rollup.config.mjs",
"clean": "rimraf ./dist",
"watch": "tsc --watch",
"prepublishOnly": "npm run build"
},
"devDependencies": {
"@capacitor/android": "^8.0.0",
"@capacitor/core": "^8.0.0",
"@capacitor/docgen": "^0.3.1",
"@capacitor/ios": "^8.0.0",
"@ionic/eslint-config": "^0.4.0",
"@ionic/prettier-config": "^4.0.0",
"@ionic/swiftlint-config": "^2.0.0",
"eslint": "^8.57.1",
"prettier": "^3.6.2",
"prettier-plugin-java": "^2.7.7",
"rimraf": "^6.1.0",
"rollup": "^4.53.2",
"swiftlint": "^2.0.0",
"typescript": "^5.9.3"
},
"peerDependencies": {
"@capacitor/core": ">=8.0.0"
},
"prettier": "@ionic/prettier-config",
"swiftlint": "@ionic/swiftlint-config",
"eslintConfig": {
"extends": "@ionic/eslint-config/recommended"
},
"capacitor": {
"ios": {
"src": "ios"
},
"android": {
"src": "android"
}
}
}

22
rollup.config.mjs Normal file
View File

@ -0,0 +1,22 @@
export default {
input: 'dist/esm/index.js',
output: [
{
file: 'dist/plugin.js',
format: 'iife',
name: 'capacitorPrinter',
globals: {
'@capacitor/core': 'capacitorExports',
},
sourcemap: true,
inlineDynamicImports: true,
},
{
file: 'dist/plugin.cjs.js',
format: 'cjs',
sourcemap: true,
inlineDynamicImports: true,
},
],
external: ['@capacitor/core'],
};

58
src/definitions.ts Normal file
View File

@ -0,0 +1,58 @@
export interface PrinterDevice {
name: string;
address: string; // MAC for BT, IP for Network, deviceId string for USB
}
export interface BluetoothPrintOptions {
address: string;
data: number[];
}
export interface NetworkPrintOptions {
host: string;
port?: number; // default 9100
data: number[];
}
export interface UsbPrintOptions {
data: number[];
deviceId?: string;
}
export interface PermissionResult {
bluetooth: 'granted' | 'denied' | 'prompt';
network: 'granted' | 'denied' | 'prompt';
}
/**
* @capacitor-pozo-printer
*/
export interface PrinterPlugin {
requestPermissions(): Promise<PermissionResult>;
/**
* Scan paired Bluetooth devices
*/
scanBluetooth(): Promise<{ devices: PrinterDevice[] }>;
/**
* Scan connected USB devices
*/
scanUsb(): Promise<{ devices: PrinterDevice[] }>;
/**
* Print via Bluetooth SPP
*/
printBluetooth(options: BluetoothPrintOptions): Promise<{ success: boolean }>;
/**
* Print via Network/LAN/WiFi (TCP port 9100)
*/
printNetwork(options: NetworkPrintOptions): Promise<{ success: boolean }>;
/**
* Print via USB OTG
*/
printUsb(options: UsbPrintOptions): Promise<{ success: boolean }>;
}

9
src/index.ts Normal file
View File

@ -0,0 +1,9 @@
import { registerPlugin } from '@capacitor/core';
import type { PrinterPlugin } from './definitions';
const Printer = registerPlugin<PrinterPlugin>('Printer', {
web: () => import('./web').then((m) => new m.PrinterWeb()),
});
export * from './definitions';
export { Printer };

40
src/web.ts Normal file
View File

@ -0,0 +1,40 @@
import { WebPlugin } from '@capacitor/core';
import type {
PrinterPlugin,
PrinterDevice,
BluetoothPrintOptions,
NetworkPrintOptions,
UsbPrintOptions,
PermissionResult
} from './definitions';
export class PrinterWeb extends WebPlugin implements PrinterPlugin {
async scanBluetooth(): Promise<{ devices: PrinterDevice[] }> {
console.warn('Bluetooth not available on web');
return { devices: [] };
}
async scanUsb(): Promise<{ devices: PrinterDevice[] }> {
console.warn('USB not available on web');
return { devices: [] };
}
async printBluetooth(_options: BluetoothPrintOptions): Promise<{ success: boolean }> {
console.warn('Bluetooth printing not available on web');
return { success: false };
}
async printNetwork(_options: NetworkPrintOptions): Promise<{ success: boolean }> {
console.warn('Network printing not available on web');
return { success: false };
}
async printUsb(_options: UsbPrintOptions): Promise<{ success: boolean }> {
console.warn('USB printing not available on web');
return { success: false };
}
async requestPermissions(): Promise<PermissionResult> {
return { bluetooth: 'granted', network: 'granted' };
}
}

21
tsconfig.json Normal file
View File

@ -0,0 +1,21 @@
{
"compilerOptions": {
"allowUnreachableCode": false,
"declaration": true,
"esModuleInterop": true,
"inlineSources": true,
"lib": ["dom", "es2017"],
"module": "esnext",
"moduleResolution": "node",
"noFallthroughCasesInSwitch": true,
"noUnusedLocals": true,
"noUnusedParameters": true,
"outDir": "dist/esm",
"pretty": true,
"sourceMap": true,
"strict": true,
"target": "es2017",
"skipLibCheck": true
},
"files": ["src/index.ts"]
}