Uniapp使用大疆SDK打包离线原生插件二

上一篇讲了如何下载及配置原生插件，今天深入的了解下如何将java代码的SDK引入Uniapp

一、配置libs:

在Android开发中，libs目录通常用于存放项目所需的第三方库文件。

将sdk中的包lib.5plus.base-release.aar、android-gif-drawable-release@1.2.23.aar、uniapp-v8-release.aar和oaid_sdk_1.0.25.aar拷贝到创建的空项目中的libs目录下；

注意：如果需要集成的第三方sdk存在so库文件，只需添加armeabi-v7a、arm64-v8a、x86三个文件夹即可，否则会导致在部分手机上无法运行。

二、配置build.gradle

build.gradle文件是Android项目的构建配置文件，用于定义项目的构建规则和依赖项。以下是详细的配置说明：

复制代码

apply plugin: 'com.android.application'



android {

  compileSdkVersion 29

  defaultConfig {

      applicationId "com.example.myapplication"

      minSdkVersion 21

      targetSdkVersion 28

      versionCode 1

      versionName "1.0"

      multiDexEnabled true

      ndk {

          abiFilters 'x86', 'armeabi-v7a', 'arm64-v8a'

      }

  }

  buildTypes {

      release {

          minifyEnabled false

          proguardFiles getDefaultProguardFile('proguard-android-optimize.txt'), 'proguard-rules.pro'

      }

  }

}



dependencies {

  implementation fileTree(dir: 'libs', include: ['*.aar', '*.jar'], exclude: [])

  implementation 'androidx.appcompat:appcompat:1.0.0'

  implementation 'androidx.legacy:legacy-support-v4:1.0.0'

  implementation 'com.alibaba:fastjson:1.1.46.android'

}

三、申请appkey

appkey是应用在DCloud平台上的唯一标识符，用于验证应用的合法性。以下是申请appkey的步骤：

访问官方链接：打开DCloud官方文档。
按照指南申请：根据文档中的步骤，填写相关信息并提交申请。
获取appkey：申请成功后，系统会生成一个唯一的appkey，请妥善保存。
*申请appkey 参考官方链接申请 | uni小程序SDK

四、配置Androidmanifest.xml中的appkey：

AndroidManifest.xml是Android应用的配置文件，用于声明应用的基本信息和组件。
application节点下的meta-data节点属性

android:name="dcloud_appkey"不改

android:value="替换为自己申请的Appkey" 修改为自己申请的appkey

<application

...>

<meta-data

android:name="dcloud_appkey"

android:value="替换为自己申请的Appkey" />

五、注册插件

在UniApp中，插件需要通过实现UniAppHookProxy接口来注册。

创建一个实体类并实现UniAppHookProxy接口，在onCreate函数中添加组件注册相关参数或填写插件需要在启动时初始化的逻辑。

public class RichAlert_AppProxy implements UniAppHookProxy {

@Override

public void onCreate(Application application) {

//当前uni应用进程回调仅触发一次多进程不会触发

//可通过UniSDKEngine注册UniModule或者UniComponent

}

@Override

public void onSubProcessCreate(Application application) {

//其他子进程初始化回调可用于初始化需要子进程初始化需要的逻辑

}

在hooksClass节点添加你创建实现UniAppHookProxy接口的实体类完整名称填入其中即可

六、调试原生插件：

使用hx（hbuiderx）创建uniapp项目

创建vue页面或者nvue，在js中第一行获取插件对象var testModule = uni.requireNativePlugin("TestModule")

然后使用插件对象就可以调用到插件中的方法

在hx上的菜单上：发行-原生app-本地打包-生成本地app打包资源；

打包完成会在控制台上输出打包信息，我们关注的是打包路径；

打包资源放入创建的android空项目对应的目录中：

android空项目的资源路径：app/src/main/assets/apps/appid/www,如果没有某个目录自己手动建立即可；

appid获取方式：

在uniapp项目中打开文件manifest.json中就可以查看到。

拷贝sdk中提供的data文件夹：

路径位于Android-SDK@3.2.3.81011_20210826\SDK\assets

修改拷贝的data文件夹下的dcloud_control.xml：

appid替换为自己的appid