uniapp开发android原生插件_uniplugin-hello-as

一、下载原生开发SDK

           Android 离线SDK - 正式版 | uni小程序SDK (dcloud.net.cn)、

           https://nativesupport.dcloud.net.cn/AppDocs/download/android.html

          将开发uniappa原生android的插件解压到ben本地目录，目录结构如下：

          接下就可以使用 UniPlugin-Hello-AS这个工程制作原生插件

二、制作原生插件

1、androidstudio打开UniPlugin-Hello-AS

        调整好本地androidsdk和gradle环境进行下一步

2、创建一个library的module

3、配置gradle依赖

        将uniplugin_modle模块下的gradle依赖全部拷贝到新建的mylibrary的gradle中

    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.0.0'
    implementation 'com.alibaba:fastjson:1.2.83'
    implementation 'com.facebook.fresco:fresco:1.13.0'

4、编写android代码

/**
 * 提供给uni的js调用的类需要继承  io.dcloud.feature.uniapp.common.UniModule
*  这里定义的java类名就是后面uniapp调用的插件名称
*/
public class MyLibraryPlugin  extends UniModule {
 
    /**
     * 暴露一个给js调用的方法
     * UniJSMethod注解标记是否需要主线程调用
     * @return
     */
    @UniJSMethod(uiThread = false)
    public   String  getTimeFromNative(){
        SimpleDateFormat sdf = new SimpleDateFormat("yyyy-MM-dd  HH:mm:ss", Locale.CHINA);
        return  "get time from native " + sdf.format(new Date());
    }
    
}

5、打包aar文件

         进入到工程的根目录，执行assembleRelease命令

 ./gradlew   mylibrary:assembleRelease

        在build->outputs->aar提取aar文件

      这样就生成了一个名为mylibrary-release.aar的插件

6、编写插件打包配置package.json

{  
    "name": "MyLibraryPlugin",  
    "id": "MyLibraryPlugin",  
    "version": "1.0",  
    "description": "uniapp原生android插件",  
    "_dp_type":"nativeplugin",  
    "_dp_nativeplugin":{    
        "android": {  
            "plugins": [  
                {  
                 "type": "module",
                 "name": "SunMiUtilsService",
                 "class": "com.example.mylibrary.MyLibraryPlugin"
                }
            ],   
            "integrateType": "aar",  
            "minSdkVersion": "21"  
        }  
    }  
}

       这样package.json文件就配置好了 

三、uniapp集成插件

 1、导入原生插件

        在uniapp项目目录下创建一个名为nativeplugins的文件夹，在nativeplugins目录下创建目录以插件名称MyLibraryPlugin命名，在MyLibraryPlugin插件目录下创建一个android目录，将mylibrary-release.aar插件拷贝进去，在android的统计目录中奖package.json文件拷贝进去，整体目录结构如下：

2、在manifest.json中配置插件

3、测试代码

methods: {
   clickNative(){
	 const  libPlugin =  uni.requireNativePlugin("MyLibraryPlugin");
	 uni.showModal({
		title:'提示',
		content: libPlugin.getTimeFromNative(),
	  })
	},
}

         注意：新引入插件一定要重新对自定义基座进行打包，不然插件引入会失效