221 cordova capacitor react integration

docs/enioka-scan-compat-package.md

@@ -0,0 +1,113 @@
+# Compatibility layer for various android application frameworks
+
+enioka-scan provides npm packages that aim at facilitating its integration within already existing apps.
+
+## For all android projects
+You need to add the matching dependencing, depending on what physical device you wish to use.
+
+in ``android/app/build.gradle``
+```gradle
+dependencies {
+    //core library
+    implementation group: 'com.enioka.scanner', name: 'enioka-scan-core', version: '3.0.1'
+    //use camera
+    implementation group: 'com.enioka.scanner', name: 'provider-os-camera', version: '3.0.1'
+
+    //provider dependant, here is for honeywell scanner.
+
+    implementation group: 'com.enioka.scanner', name: 'provider-os-honeywell-integrated', version: '3.0.1'
+}
+```
+*(using  the ``mavenCentral()`` repository )*
+
+
+You can then implement your own logic and Activities by creating a class extending ``ScannerCompatActivity``.
+
+```java
+import com.enioka.scanner.activities.ScannerCompatActivity;
+
+public class MyScanActivity extends ScannerCompatActivity {
+
+    @Override
+    public void initCamera(){
+        super.initCamera();
+
+        //initCamera logic...
+    }
+
+    @Override
+    public void onData(List<Barcode> data) 
+    {
+    //onData Logic
+    }
+
+    //rest of the Activity logic      
+}
+
+```
+
+## Cordova
+Cordova has its own plugin system
+You can add the compat library using 
+
+```bash
+$ cordova plugin add enioka-scan-compat
+```
+
+in any .js file :
+
+```js
+
+function foo() 
+{
+    window.startActivityNow(
+        {className:"com.example.myapp.MyScanActivity"},
+        successHandler,
+        errorHandler
+    )
+}
+```
+
+
+## Capacitor
+Capcitor supports cordova modules installed with npm
+
+``` bash
+$ npm install enioka-scan-compat-
+```
+
+
+
+```html
+<script src="js/index.js" type="module"></script>
+```
+
+```js
+function foo() {
+    window.startActivityNow(
+        {className:"com.example.myapp.MyScanActivity"},
+        successHandler,
+        errorHandler
+    )
+}
+```
+
+## React Native
+
+``` bash
+$ npm install enioka-scan-compat-
+```
+
+```tsx
+import { startActivity } from 'enioka-scan-compat-'
+
+<Button title = "startActivity" onPress={() => startActivity("com.example.myapp.MyScanActivity")}>
+</Button>
+```
+
+## Troubleshooting
+
+- in gradle.properties : 
+``android.enableJetifier=true``
+- in AndroidManifest.xml
+``android.allowBackup=true``

npm_integration_frameworks/cordova-capacitor/package.json

@@ -0,0 +1,21 @@
+{
+    "name": "@enioka/enioka-scan-cordova-capacitor-integration",
+    "version": "0.1.0",
+    "description": "enioka scan plugin cordova",
+    "main": "main.js",
+    "cordova": {
+      "id": "enioka-scan-cordova-capacitor-integration",
+      "platforms": [
+        "android"
+      ]
+    },
+    "keywords": [
+      "enioka",
+      "enioka-scan",
+      "scanner",
+      "integration-layer",
+      "capacitor"
+    ],
+    "author": "enioka",
+    "license": "MIT"
+  }

npm_integration_frameworks/cordova-capacitor/plugin.xml

@@ -0,0 +1,28 @@
+<?xml version="1.0" encoding="utf-8"?>
+<plugin xmlns="http://apache.org/cordova/ns/plugins/1.0"
+        id="enioka-scan-cordova-capacitor-integration"
+        version="0.1.0">
+
+  <name>ActivityStarterPlugin</name>
+
+  <engines>
+    <engine name="cordova" version=">=12.0.0"/>
+  </engines>
+
+  <asset src="www/main.js" target="js/main.js"/>
+
+  <js-module src="www/main.js" name="main">
+    <clobbers target="ActivityStarterPlugin"/>
+  </js-module>
+
+  <platform name="android">
+
+    <config-file target="res/xml/config.xml" parent="/*">
+      <feature name="ActivityStarterPlugin">
+        <param name="android-package" value="com.enioka.plugin.ActivityStarterPlugin"/>
+      </feature>
+    </config-file>
+
+    <source-file src="src/android/ActivityStarterPlugin.java" target-dir="src/com/enioka/plugin/"/>
+    </platform>
+</plugin>

npm_integration_frameworks/cordova-capacitor/src/android/ActivityStarterPlugin.java

@@ -0,0 +1,50 @@
+import android.content.Intent;
+import android.util.Log;
+import org.apache.cordova.CallbackContext;
+import org.apache.cordova.CordovaPlugin;
+import org.apache.cordova.PluginResult;
+import org.json.JSONArray;
+import org.json.JSONException;
+import java.lang.ClassNotFoundException;
+
+public class ActivityStarterPlugin extends CordovaPlugin {
+
+    private static final String LOG_TAG = "ActivityStarter";
+    private static final String startActivityActionName = "startActivity";
+
+    public ActivityStarterPlugin() {
+}
+    public boolean execute(String action, JSONArray args, final CallbackContext callbackContext)
+    {
+        String targetActivityName = "";
+        Class<?> klass;
+        Log.d(LOG_TAG, "Received Action: " + action);
+
+        if (action.equals(startActivityActionName)){
+            try {
+                targetActivityName = args.getJSONObject(0).getString("targetActivityName");
+                Log.d(LOG_TAG, "targetActivityName : " + targetActivityName);
+                klass = Class.forName(targetActivityName);
+            }
+            catch(ClassNotFoundException e){
+                Log.e(LOG_TAG, e.toString());
+                callbackContext.sendPluginResult(new PluginResult(PluginResult.Status.CLASS_NOT_FOUND_EXCEPTION));
+                return false;
+            }
+            catch (JSONException e){
+                Log.e(LOG_TAG, e.toString());
+                callbackContext.sendPluginResult(new PluginResult(PluginResult.Status.ERROR));
+                return false;
+            }
+
+            Intent intent = new Intent(this.cordova.getContext(), klass);
+            this.cordova.getActivity().startActivity(intent);
+            callbackContext.sendPluginResult(new PluginResult(PluginResult.Status.OK));
+            return true;
+        }
+
+        Log.e(LOG_TAG, "Invalid Action");
+        callbackContext.sendPluginResult(new PluginResult(PluginResult.Status.INVALID_ACTION));
+        return false;
+    }
+}

npm_integration_frameworks/cordova-capacitor/www/main.js

@@ -0,0 +1,5 @@
+var exec = require('cordova/exec');
+
+window.startActivity = function (params, successCallback, errorCallback) {
+    exec(successCallback, errorCallback, "ActivityStarterPlugin", "startActivity", [params]);
+};

npm_integration_frameworks/reactnative/.gitattributes

@@ -0,0 +1,3 @@
+*.pbxproj -text
+# specific for windows script files
+*.bat text eol=crlf

npm_integration_frameworks/reactnative/.gitignore

@@ -0,0 +1,82 @@
+# OSX
+#
+.DS_Store
+
+# XDE
+.expo/
+
+# VSCode
+.vscode/
+jsconfig.json
+
+# Xcode
+#
+build/
+*.pbxuser
+!default.pbxuser
+*.mode1v3
+!default.mode1v3
+*.mode2v3
+!default.mode2v3
+*.perspectivev3
+!default.perspectivev3
+xcuserdata
+*.xccheckout
+*.moved-aside
+DerivedData
+*.hmap
+*.ipa
+*.xcuserstate
+project.xcworkspace
+
+# Android/IJ
+#
+.classpath
+.cxx
+.gradle
+.idea
+.project
+.settings
+local.properties
+android.iml
+
+# Cocoapods
+#
+example/ios/Pods
+
+# Ruby
+example/vendor/
+
+# node.js
+#
+node_modules/
+npm-debug.log
+yarn-debug.log
+yarn-error.log
+
+# BUCK
+buck-out/
+\.buckd/
+android/app/libs
+android/keystores/debug.keystore
+
+# Yarn
+.yarn/*
+!.yarn/patches
+!.yarn/plugins
+!.yarn/releases
+!.yarn/sdks
+!.yarn/versions
+
+# Expo
+.expo/
+
+# Turborepo
+.turbo/
+
+# generated by bob
+lib/
+
+# React Native Codegen
+ios/generated
+android/generated

npm_integration_frameworks/reactnative/.nvmrc

@@ -0,0 +1 @@
+v18

npm_integration_frameworks/reactnative/.yarnrc.yml

@@ -0,0 +1,10 @@
+nodeLinker: node-modules
+nmHoistingLimits: workspaces
+
+plugins:
+  - path: .yarn/plugins/@yarnpkg/plugin-interactive-tools.cjs
+    spec: "@yarnpkg/plugin-interactive-tools"
+  - path: .yarn/plugins/@yarnpkg/plugin-workspace-tools.cjs
+    spec: "@yarnpkg/plugin-workspace-tools"
+
+yarnPath: .yarn/releases/yarn-3.6.1.cjs