【uniapp】原生插件开发

uniapp 原生插件的开发

uni原生插件开发教程

1 下载

• 下载 Android Studio 官网

  • Android Studio 下载教程
  • Android Studio 入门教程 新建项目

• 下载：App 离线 SDK Android 离线SDK - 正式版

2 示例工程导入

uniapp Android 原生插件开发（Module 扩展为例·2022）

• 用 Android Studio 打开 UniPlugin-Hello-AS 文件夹
• 等待 build 成功

2.1 build 错误

构建警告：将新 ns 映射到旧 ns

Warning: Mapping new ns http://schemas.android.com/repository/android/common/02 to old ns http://schemas.android.com/repository/android/common/01

2.1.1 手动修改

1. 手动修改版本
   • Mapping new ns http://schemas.android.com/repository/android/common/02 to old ns 解决方法
   • Warning: Mapping new ns http://schemas.android.com/repository/android/common/02 to old ns http://sch

根本的解决方案是升级 gradle

• 修改 项目根目录/gradle/gradle-wrapper.properties

distributionUrl=https\://services.gradle.org/distributions/gradle-7.2-all.zip

• 修改 项目根目录/build.gradle

dependencies {
    classpath 'com.android.tools.build:gradle:7.0.4'
}

2. 修改以上步骤，出现新错误，Gradle 版本不匹配

Minimum supported Gradle version is 7.0.2. Current version is 6.5.

2.1.2 自动修改

更新Gradle和AGP可以手动更改，但是推荐使用工具自动升级，因为AGP的版本必须和Gradle的版本保持对应关系，工具会自动保持对应的版本。

Android编译出现Warning: Mapping new ns to old ns的解决方案

• 点击 Tools 菜单，选择最下面的AGP Upgrade Assistant

1. 升级 Android Studio 版本

   • Android Studio 版本要在 4.2 以上才有AGP Upgrade Assistant，若没有，先升级
   • 点击 help 菜单，点击 Check for undates，点击下方 Run selected steps，等待升级

   

2. 升级 Gradle 版本

   • 点击 Tools 菜单，选择最下面的AGP Upgrade Assistant，点击下方 Run selected steps，等待升级

3 开发与调试插件（在 Android Studio）

• 设置一个插件，并用 uniapp 打开
• 继续 uniapp Android 原生插件开发（Module 扩展为例·2022） 中的步骤
• uniapp如何开发原生插件？踩坑指南（一）

3.1 运行错误

1. minSdkVersion 版本问题

   • Manifest merger failed : uses-sdk:minSdkVersion 21 cannot be smaller than version 24

2. 未配置AppKey或配置错误问题

   • uniAPP 原生插件测试 提示 未配置AppKey或配置错误问题排查
   • 安卓打包，未配置appkey或其他配置错误
   • 未配置appkey或配置错误！怎么解决
   • 项目配置都正确怎么还是提示"未配置AppKey或配置错误"？

4 uniapp 使用插件（在 HBuilderX）

继续 uniapp Android 原生插件开发（Module 扩展为例·2022） 中的步骤

4.1 Gradle 错误

1. 若 Gradle 中没有 assembleRelease

   • 解决Android Studio 右上角Gradle不显示task
   • File -> Settings -> Experimental -> 取消勾选 only include test tasks in the Gradle task list generated during Gradle Sync

   

   • 点击右上角同步项目