一.参考资料与环境准备
- 原生工程配置
- 需要使用到Android studio和HbuilderX
- 当前测试的as版本-20240301,下载地址：
- HbuilderX版本：4.36
二.插件创建流程
-
1.导入下载的UniPlugin-Hello-AS工程（下载地址见参考资料）
-
2.生成jks证书
- 2.1.通过命令行生成jsk证书，假设jks名称为myjks，则输入以下命令
keytool -genkeypair -alias myjks -keyalg RSA -keystore myjks.keystore -keysize 2048 -validity 36500 -sigalg SHA256withRSA- 2.2.将证书格式转一下
keytool -importkeystore -srckeystore myjks.keystore -srcstoretype PKCS12 -deststoretype JKS -destkeystore myjks.jks -
使用命令获取SHA1和SHA256两个值（下方第三步中会使用到）
keytool -list -v -keystore myjks.jks -
3.在uniapp后台添加离线打包的配置
-
在后台选择使用HbuilderX创建的项目，选择“离线打包Key管理”，按照下图方式进行配置
-
保存之后选择“创建离线key”，记录生成的key为Android对应的value的值
-
-
4.打包本地资源
- 将生成的本地资源放入文件夹中（UniPlugin-Hello-AS\app\src\main\assets\apps）
-
5.删除UniPlugin-Hello-AS自带的module，新建一个module（假设取名为mylibrary）
-
5.1.更改mylibrary的内容，添加文件
-
5.2.更改mylibrary的build.gradle中内容,
plugins { id 'com.android.library' } android { compileSdkVersion 35 namespace 'com.example.mylibrary' defaultConfig { minSdk 24 ndk { moduleName "NDK" abiFilters 'armeabi', 'x86', 'armeabi-v7a', 'x86_64', 'arm64-v8a' } testInstrumentationRunner "androidx.test.runner.AndroidJUnitRunner" consumerProguardFiles "consumer-rules.pro" } buildTypes { release { minifyEnabled false proguardFiles getDefaultProguardFile('proguard-android-optimize.txt'), 'proguard-rules.pro' } } compileOptions { sourceCompatibility JavaVersion.VERSION_11 targetCompatibility JavaVersion.VERSION_11 } sourceSets { main { jni.srcDirs = ['libs'] jni.srcDirs = ['src/main/jniLibs'] jniLibs.srcDir 'src/main/jniLibs' } } } dependencies { implementation files('src\\libs\\AclasDriverSdk.jar') implementation files('src\\libs\\LABLE_USB_SDK_V01.08.jar') implementation files('src\\libs\\NeoStraElectronicSDK-3-v1.3_2302281129.jar') implementation files('src\\libs\\zxing.jar') compileOnly fileTree(dir: 'libs', include: ['*.jar']) compileOnly fileTree(dir: '../app/libs', include: ['uniapp-v8-release.aar']) // compileOnly 'androidx.recyclerview:recyclerview:1.0.0' // compileOnly 'androidx.legacy:legacy-support-v4:1.0.0' compileOnly 'androidx.appcompat:appcompat:1.6.1' implementation 'com.alibaba:fastjson:1.2.83' implementation 'com.facebook.fresco:fresco:1.13.0' implementation 'com.github.bumptech.glide:glide:4.16.0' implementation 'androidx.appcompat:appcompat:1.6.1' implementation 'com.google.android.material:material:1.10.0' testImplementation 'junit:junit:4.13.2' androidTestImplementation 'androidx.test.ext:junit:1.1.5' androidTestImplementation 'androidx.test.espresso:espresso-core:3.5.1' } -
-
6.开始写自定义插件的逻辑
- 新建Java文件， MyPlug.java，文件中定义的两个方法init和printInfo可以由uniapp项目进行调用，后续说明
public class MyPlug extends UniModule { //定义方法一，uniapp项目调用不需要传递参数 @UniJSMethod public void init(UniJSCallback callback) { JSONObject data = new JSONObject(); data.put("code", "success"); data.put("data", "操作成功"); callback.invoke(data); } //定义方法二，uniapp项目调用可以传递参数 @UniJSMethod public void printInfo(int markType, String width, String height, String jsonInfo, UniJSCallback callback) throws IOException { JSONObject data = new JSONObject(); data.put("code", "success"); data.put("data", "操作成功"); callback.invoke(data); } } -
7.更改\UniPlugin-Hello-AS\app\src\main\AndroidManifest.xml中的内容
将<meta-data android:name="dcloud_appkey" android:value="开发者需登录https://dev.dcloud.net.cn/申请签名" /> 更改成 <meta-data android:name="dcloud_appkey" android:value="78b2a45f4274af99fa17d63615458ecd" /> -
8.更改\UniPlugin-Hello-AS\app\src\build.gradle中的内容
applicationId "www.test555.com" //更改1，www.test555.com为在uniapp后台配置的包名 //signingConfigs中的jks替换成自己生成的 signingConfigs { config { keyAlias 'myjks' keyPassword '123456' storeFile file('myjks.jks') storePassword '123456' v1SigningEnabled true v2SigningEnabled true } } // 添加uni-app插件 dependencies { //... // 添加uni-app插件 implementation project(':mylibrary') } -
9.更改\UniPlugin-Hello-AS\app\src\main\assets\dcloud_uniplugins.json中的内容
{
"nativePlugins": [
{
"hooksClass": "",
"plugins": [
{
"type": "module",
"name": "testPlug",
"class": "com.example.mylibrary.MyPlug"
}
]
}
]
}
- 10.更改\UniPlugin-Hello-AS\app\src\main\data__UNI__F089EA2\dcloud_control.xml中的内容
<hbuilder>
<apps>
<app appid="__UNI__F089EA2" appver=""/>
</apps>
</hbuilder>
-
11.使用Android studio 生成mylibrary的arr文件
-
12.uniapp项目引入插件
-
按照截图的格式创建好文件夹和对应的文件（保持名称一致）
-
package.json的配置如下
{ "name": "testPlug", "id": "testPlug", "version": "1", "description": "这里是描述", "_dp_type":"nativeplugin", "_dp_nativeplugin":{ "android": { "plugins": [ { "type": "module", "name": "testPlug", "class": "com.example.mylibrary.MyPlug" } ], "integrateType": "aar", "dependencies": [], "compileOptions": { "sourceCompatibility": "11", "targetCompatibility": "11" }, "minSdkVersion": "24" } } }- 将11中生成的arr文件放入到nativeplugins\testPlug\android文件夹下
- uniapp项目要添加本地插件的依赖
-
-
13.uniapp项目使用插件
<template>
<view style="margin: 80rpx 20rpx;">
<div style="margin-top: 15rpx;">
<button type="primary" @click="test1">领料标签</button>
</div>
</view>
</template>
<script>
// 1.引入插件
let testPlugModule = uni.requireNativePlugin("testPlug")
export default {
data() {
return {
title: 'Hello'
}
},
onLoad() {
this.inits();
},
methods: {
inits() {
//2.调用插件方法，不传递参数
testPlugModule.init((res) => {
uni.showToast({
title: res.data,
icon: "none"
})
})
},
test1() {
//缺少原料字段
var beanInfo1 = {
itemId: "12345678",
itemCode: "999",
itemName: "毛豆",
itemBarcode: "0123456789",
chargeBy: "王德发"
}
var jsonBean = JSON.stringify(beanInfo1);
console.log("查看参数信息 jsonBean = ", jsonBean)
this.info1 = jsonBean
//3.调用插件方法，传递参数
testPlugModule.printInfo(1,this.width,this.height, jsonBean, (res) => {
uni.showToast({
title: res.data,
icon: "none"
})
})
},
}
}
</script>
<style>
.content {
display: flex;
flex-direction: column;
align-items: center;
justify-content: center;
}
.logo {
height: 200rpx;
width: 200rpx;
margin-top: 200rpx;
margin-left: auto;
margin-right: auto;
margin-bottom: 50rpx;
}
.text-area {
display: flex;
justify-content: center;
}
.title {
font-size: 36rpx;
color: #8f8f94;
}
</style>
- 14.重新执行步骤4，然后测试
三.总结
- 按照上方流程则可以实现uniapp调用安卓原生插件。
![[春秋云镜] Tsclient仿真场景](https://i-blog.csdnimg.cn/direct/336653a53da3445db4bb16a78e6a8939.png)
![[Windows] 音速启动 1.0.0.0](https://i-blog.csdnimg.cn/direct/d5a80902c1ab40db9761b301723dc765.png)
