https://ask.dcloud.net.cn/article/35416
项目需要基于uniapp 开发原生组件 。
一、简介
本文档介绍如何在uni-app中基于weexsdk 开发AndroID原生插件。
更多说明请参考uni-app原生插件开发指南。
在您阅读此文档时，我们假定您已经具备了相应AndroID应用开发经验，使用AndroID Studio开发过AndroID原生。学习过 weex 知识并能够理解相关概念。您也应该对HTML,JavaScript,CSS等有一定的了解, 并且熟悉在JavaScript和JAVA环境下的JsON格式数据 *** 作等。
三、前期准备安装JDK version>=1.7 并配置了环境变量安装AndroID SDK 并配置环境变量。安装AndroID Studio 尽量使用最新版本！下载地址：Android Studio官网 OR Android Studio中文社区5+SDK下载：最新android平台SDK下载学习weex 0.26.0版本框架API。weex扩展API for android四、插件开发导入UniPlugin-Hello-AS工程
UniPlugin-Hello-AS工程请在5+SDK中查找
点击AndroID Studio菜单选项file--->New--->import Project。
导入选择UniPlugin-Hello-AS工程，点击OK! 等待工程导入完毕。
如果出现AndroID SDK路径不对问题，请在AndroID Studio中鼠标右键UniPlugin-Hello-AS选择Open Module Settings, 在SDK Location 中设置相关环境路径
注意！工程gradle配置的gradle-4.6-all版本！使用的是新版本的依赖方式，如果您使用的是老版本的gradle。可根据以下链接进行修改依赖方式。
gradle新依赖方式与旧依赖方式的不同
创建uni-app插件Module
点击AndroID Studio 菜单项 file--->New--->New Module。
选择AndroID library, 点击Next.填写与插件相关信息点击finish。
@L_404_14@
编辑module的build.gradle文件。添加依赖库
AndroID Studio默认会在dependencIEs节点下添加一些基本依赖库，如下图红框内的引用注释掉 或 改为compileOnly依赖方式
此处需要注意libs文件夹下的jar文件已改为compileOnly方式引用了。当你离线工程调试时需要把插件中用到的jar文件在app工程的build.gradle中配置相应的jar文件implementation引入。一定要注意！！！否则导致应用闪退等问题。至于插件中用到的jar文件在打插件包时文件到底放在什么位置请留意插件打包文档。
加入以下引用（出现底色标红表示当前引用版本与compileSdkVersion版本不同，忽略即可）
复制代码compileOnly "com.androID.support:recyclervIEw-v7:26.1.0" compileOnly "com.androID.support:support-v4:26.1.0" compileOnly "com.androID.support:appcompat-v7:26.1.0"
dependencIEs节点添加依赖库时需使用compileOnly依赖方式！ 防止打包时与其他插件资源库冲突导致打包失败！！
导入uniapp-release.aar
复制代码 repositorIEs { flatDir { dirs 'libs' } } dependencIEs节点里添加 :
(注意：此添dir需根据具体工程目录配置，当前写法仅适用于UniPlugin-Hello-AS工程)
复制代码compileOnly filetree(dir: '../app/libs', include: ['uniapp-release.aar'])
完成以上 *** 作表示当前的Module已经具备了开发uni-app插件的能力了。
编写uni-app插件
学习Weex扩展 AndroID 知识。目前集成了Weex 0.26.0版本！！！ 如果你之前开发的是老版本代码需要作升级代码 *** 作。 weex扩展API for android特别注意uni-app插件目前仅支持Module扩展和Component扩展，暂时不支持Adapter扩展！！！
编写插件
插件 封装了一个 RichAlertWXModule, 富文本alertd窗Module。代码可参考UniPlugin-Hello-AS工程中的uniplugin_richalert模块。（UniPlugin-Hello-AS工程请在5+SDK中查找）
HBuilderX 项目中使用RichAlert示例：
复制代码// require插件名称 const dcRichAlert = uni.requireNativePlugin('DCloud-RichAlert'); // 使用插件 dcRichAlert.show({ position: 'bottom', Title: "提示信息", Titlecolor: '#FF0000', content: "<a href='https://uniapp.dcloud.io/' value='Hello uni-app'>uni-app</a> 是一个使用 Vue.Js 开发跨平台应用的前端框架!\n免费的\n免费的\n免费的\n重要的事情说三遍", contentAlign: 'left', checkBox: { Title: '不再提示', isSelected: true }, buttons: [{ Title: '取消' }, { Title: '否' }, { Title: '确认', Titlecolor: '#3F51B5' } ] }, result => { switch (result.type) { case 'button': console.log("callback---button--" + result.index); break; case 'checkBox': console.log("callback---checkBox--" + result.isSelected); break; case 'a': console.log("callback---a--" + JsON.stringify(result)); break; case 'backCancel': console.log("callback---backCancel--"); break; } }); 目前对weex支持的问题Activity的获取方式。通过mWxsdkInstance.getContext()强转Activity。建议先instanceof Activity判断一下再强转.vue暂时只能使用module形式。component还不支持在.vue下使用.vue下暂时不支持调用Js同步方法，.nvue可以使用。component的使用可参考weex写法**component、module的生命周回调，暂时只支持onActivityDestroy 、onActivityResume 、onActivityPause、onActivityResult其他后续支持。请留意更新！第三方依赖库均要使用compileOnly依赖方式，打包时需要配置或挪动文件到相关文件夹中。 打包插件介绍时会有相关的具体描述！请参考android平台所有依赖库列表, 编写自己插件时需要查看是否与编译的程序依赖有冲突，防止审核失败或编译失败等问题。对有些插件需要引用到.so文件，需要特殊配置一下.请参考Android studio添加第三方库和so代码中用到的JsONObject、JsONArray 要使用com.alibaba.fastJson.JsONArray;com.alibaba.fastJson.JsONObject; 不要使用org.Json.JsONObject;org.Json.JsONArray 否则造成参数无法正常传递使用等问题。插件编写命名规范源代码的package中一定要作者标识防止与其他插件冲突导致插件审核失败，无法上传。
如示例中插件类的“package uni.dcloud.io.uniplugin_richalert;” “dcloud”就是作者标识！Module扩展和Component扩展在引用中的name， 需要前缀加入你自己的标识，防止与其他插件名称冲突。
如示例中的插件“DCloud-RichAlert”！“DCloud”就是标识！五、本地调试测试插件并运用到uni-app中
本地注册插件
第一种方式在UniPlugin-Hello-AS工程下 “app” Module根目录assets/dcloud_uniplugins.Json文件。 在moudles节点下 添加你要注册的Module 或 Component第二种方式创建一个实体类并实现AppHookProxy接口，在onCreate函数中添加weex注册相关参数 或 填写插件需要在启动时初始化的逻辑。在UniPlugin-Hello-AS工程下 “app” Module根目录assets/dcloud_uniplugins.Json文件，在hooksClass节点添加你创建实现AppHookProxy接口的实体类完整名称填入其中即可 (有些需要初始化 *** 作的需求可以在此处添加逻辑，无特殊 *** 作仅使用第一种方式注册即可无需集成AppHookProxy接口)具体写法如图：以上两种方式选一即可
dcloud_uniplugins.Json说明:
nativePlugins： 插件跟节点 可存放多个插件hooksClass： 生命周期代理（实现AppHookProxy接口类）格式(完整包名加类名)name : 注册名称，class : module 或 component 实体类完整名称type : module 或 component类型。复制代码{ "nativePlugins": [ { "hooksClass": "uni.dcloud.io.uniplugin_richalert.apphooks", "plugins": [ { "type": "module", "name": "DCloud-RichAlert", "class": "uni.dcloud.io.uniplugin_richalert.RichAlertWXModule" } ] } ] } 本地测试运行带有插件的uni-app
安装最新HbuilderX 大于等于1.4.0.xxxxxx创建uni-app工程或在已有的uni-app工程编写相关的.nvue 和.vue文件。使用uni-app插件中的module 或 component。xxx.vue 示例代码（RichAlert为示例）
复制代码<template> <vIEw> <button @click="showRichAlert"> 点击d出RichAlert </button> </vIEw> </template> <script> // require插件名称 const dcRichAlert = uni.requireNativePlugin('DCloud-RichAlert'); export default { methods: { showRichAlert() { // 使用插件 dcRichAlert.show({ position: 'bottom', Title: "提示信息", Titlecolor: '#FF0000', content: "<a href='https://uniapp.dcloud.io/' value='Hello uni-app'>uni-app</a> 是一个使用 Vue.Js 开发跨平台应用的前端框架!\n免费的\n免费的\n免费的\n重要的事情说三遍", contentAlign: 'left', checkBox: { Title: '不再提示', isSelected: true }, buttons: [{ Title: '取消' }, { Title: '否' }, { Title: '确认', Titlecolor: '#3F51B5' }] }, result => { switch (result.type) { case 'button': console.log("callback---button--" + result.index); break; case 'checkBox': console.log("callback---checkBox--" + result.isSelected); break; case 'a': console.log("callback---a--" + JsON.stringify(result)); break; case 'backCancel': console.log("callback---backCancel--"); break; } }); } } } </script> 选择 发行--->原生APP-本地打包--->生成本地打包App资源 等待资源生成！在控制台会输出编译日志，编译成功会给出App资源路径
把APP资源文件放入到UniPlugin-Hello-AS工程下 “app” Module根目录assets/apps/测试工程appID/www对应目录下,再修改assets/data/dcloud_control.xml!修改其中appID=“测试工程appID”!,测试工程UniPlugin-Hello-AS 已有相关配置可参考。具体可查看离线打包。appID注意 一定要统一否则会导致应用无法正常运行！
配置"app"Module下的 build.gradle. 在dependencIEs节点添加插件project引用 （以uniplugin_richalert为例）
复制代码// 添加uni-app插件 implementation project(':uniplugin_richalert') 运行测试。测试运行时一切要以真机运行为主。六、打包uni-app插件选择Gradle--->插件module--->Tasks--->build--->assembleRelease编译module的aar文件注意：新版本AndroID studio将assembleRelease放入other中了
将编译依赖库文件或仓储代码放入libs目录下或配置到package.Json中在package.json填写必要的信息完整的androID 插件包包含：androID文件 里面存放XXX.aar 、libs文件夹。.aar文件 插件包libs文件夹 存放插件包依赖的第三方 .jar文件和.so文件package.Json 插件信息点击查看具体说明生成提交插件市场的.ZIP包一级目录以插件ID命名，对应package.Json中的ID字段！ 存放androID文件夹和package.Json文件。
二级目录 androID 存放安卓插件 .aar 文件 .jar .so放入到libs下
注意：.os文件需要注意 armeabi-v7a、x86 、arm64-v8a以上三种类型的.so必须要有，如果没有无法正常使用！！本地uni-app原生插件提交云端打包七、如果想要共享给其他开发者，把这个插件提交插件市场提交插件到DCloud插件市场
不提交插件市场，也可以在HBuilderX里提交云端打包。
关于第三方库引用问题：尽量去下载相关的aar或jar，然后配置到插件包相应文件夹下。aar放到androID目录下。jar放到libs目录下。如果不下载也可以。可使用compileOnly修饰，然后将相应的依赖库名称配置到package.Json中的dependencIEs节点下。
第三方库依赖冲突。一种是主app已完整集成相关第三方库。可使用用compileOnly修饰即可。如果主app仅集成了部分第三方库。可参考https://blog.csdn.net/wapchIEf/article/details/80514880
.os文件需要注意 armeabi-v7a、x86 、arm64-v8a以上三种类型的.so必须要有，如果没有无法正常使用！！
插件中包含fileProvIDer云打包冲突，可通过http://ask.dcloud.net.cn/article/36105此贴配置绕过。
插件中有资源路径返回时，请使用绝对路径file://开头防止不必要的路径转换问题。
androIDx暂时不支持。请使用v4、v7实现插件。
总结以上是内存溢出为你收集整理的uniapp安卓原生组件开发全部内容，希望文章能够帮你解决uniapp安卓原生组件开发所遇到的程序开发问题。
如果觉得内存溢出网站内容还不错，欢迎将内存溢出网站推荐给程序员好友。
欢迎分享，转载请注明来源：内存溢出
微信扫一扫
支付宝扫一扫
评论列表（0条）