从Android到React Native开发(四、打包流程解析和发布为Maven库)

本文涉及的产品
公共DNS(含HTTPDNS解析),每月1000万次HTTP解析
全局流量管理 GTM,标准版 1个月
云解析 DNS,旗舰版 1个月
简介:

1、从Android到React Native开发(一、入门)

2、从Android到React Native开发(二、通信与模块实现)

3、从Android到React Native开发(三、自定义原生控件支持)

 作为失踪人口,本篇是对前三篇React Native文章的番外补充,主要实现把React Native项目,打包为完整aar库发布到maven,提供库支持的功能,算是小众化的需求吧,不过通过本篇你可以了解:

  • React Native的资源的打包流程。
  • React Native原生依赖结构。
  • 本地多aar文件的合并实现。
  • 进一步的Gradle脚本理解。
  • 如何发布一个React Native的Maven库。

OK,Let't do it (-_^)。

 通过前几篇,你已经对React Native的项目结构、通信交互方式有了一定了解,不了解也没关系((⊙_⊙)?), 我们知道,发布一个maven库,首先你要先有一个lib模块。

 你需要在项目的android目录下,即app这个module的同级目录下,创建一个Android Library的 module:rn-library 。(当然你也可以修改 app下的 apply plugin: "com.android.application"apply plugin: 'com.android.library' ,再屏蔽applicationId)。

一、引用

 使用过React Native的应该知道,依赖的库都是通过npm install安装,安装后的所有源码存在于node_modules文件夹中,如果依赖的库需要原生代码的支持,需要通过react-native link 实现原生代码模块的引用注册。

 而手动针对Android添加过link的应该熟悉,react-native link 实际上是通过脚本,在 setting.gradle 文件中引入模块在node_modules原生路径,然后在 app 的module的build.gradle中,通过compile project(':react-native-fs')引用模块,最后在ApplicationgetPackages()方法添加模块注册。所以这里我们明确了一点,项目引用的原生模块都是通过本地project module的引用。(这很重要( ̄へ ̄))

setting.gradle

//在setting中指定模块的位置
include ':react-native-fs'
project(':react-native-fs').projectDir = new File(rootProject.projectDir, '../node_modules/react-native-fs/android')
AI 代码解读

二、创建

 看过系列篇章二的应该知道,React Native项目其实是通过ReactInstanceManager,实现对js的bundle文件加载的。所以要呈现一个React Native页面,我们可以通过ReactInstanceManager,在任意自定义Activity或者Fragment中,实现页面的显示渲染(当然你也可以直接继承ReactActivity)。这里只列关键点点代码,即ReactInstanceManager的创建和加载,如下发代码(更多可见篇章二):

 mReactInstanceManager = ReactInstanceManager.builder()
         //设置加载文件,这里从assets中加载打包好的js bundle
         .setBundleAssetName("index.android.bundle")
         //异常输出
         .setNativeModuleCallExceptionHandler(new NativeModuleCallExceptionHandler() {
             @Override
             public void handleException(Exception e) {
                 e.printStackTrace();
             }
         })
         //增加主模块注册,必须
         .addPackage(new MainReactPackage())
         //增加使用你的第三方模块注册
         .addPackage(new RNFSPackage())
         //通Application中指定的getJSMainModuleName
         .setJSMainModulePath("index")
         //是否支持开发者模式
         .setUseDeveloperSupport(false)
         //初始化生命周期
         .setInitialLifecycleState(LifecycleState.RESUMED)
         //设置Application
         .setApplication(getActivity().getApplication())
         .build();
        //js代码中注册的的Component名字 AppRegistry.registerComponent('AppModule', () => App);
        String moduleName = "AppModule";
        //通过页面中已经声明好ReactRootView,启动
        mReactRootView.startReactApplication(mReactInstanceManager, moduleName, null);
AI 代码解读

1、bundle文件

 从上方代码可以看出,我们直接加载 assets 目录下的bundle文件index.android.bundle当然你可以从本地或者网络加载jsbundle文件也是可以),它的生成和拷贝是通过react-native目录下的react.gradle脚本实现的。这个脚本会读取一些配置路径,然后执行命令行打包和拷贝需要的资源,所以和app的build.gradle文件一样,在rn-library的build.gradle文件顶部增加引入即可,打包后,默认生成的bundle文为即为index.android.bundle文件.。

//引入react脚本
apply from: "../../node_modules/react-native/react.gradle"
AI 代码解读

2、资源文件

 这里有一个需要额外关注的点:根据node_nodules/react-native/local-cli/bundle/目录下的assetPathUtils.js文件中,getAndroidResourceIdentifier方法的源码可知,js文件中引用本地的静态资源文件,如果存在多级目录,是会被Encode处理的,其中/会被替换为_,数字会被屏蔽,assets_会被屏蔽。

function getAndroidResourceIdentifier(asset: PackagerAsset) {
  var folderPath = getBasePath(asset);
  return (folderPath + '/' + asset.name)
    .toLowerCase()
    .replace(/\//g, '_')           // Encode folder structure in file name
    .replace(/([^a-z0-9_])/g, '')  // Remove illegal chars
    .replace(/^assets_/, '');      // Remove "assets_" prefix
}
AI 代码解读

 所以,比如放在React Native项目根目录下的img/pic/logo.png的资源,其实编译时,会被重命名后,拷贝merged到对应的是drawable目录下,比如drawable-xxhdpi下的img_pic_logo.png。这一切都是由react native中的脚本执行的。不过默认情况下,生成拷贝的bundle文件和resources资源路径,是无法被打包到aar中的。所以如下代码所示,我们需要配置生成的资源自动添加到aar文件中。

//默认路径
//jsBundleDirRelease: "$buildDir/intermediates/assets/release
//resourcesDirRelease: "$buildDir/intermediates/res/merged/release

//修改为
project.ext.react = [
   jsBundleDirRelease: "$buildDir/intermediates/bundles/release/assets",
   resourcesDirRelease: "$buildDir/intermediates/bundles/release/res",
]
AI 代码解读

三、打包

 上面说过:React Native项目引用的原生模块,都是通过本地project module的引用。那么默认的maven发布方式,只会发布指定module的aar文件,对于引用的其他module模块,这些dependencies列在了与aar文件同目录的.pom文件中,并不会打包仅aar,而明显React Native的这些第三方支持包,并不是Maven库。

 这时候,就需要通过gradle脚本,手动对依赖的module模块,实现aar文件内容的合并。aar文件本身和Apk一样,其实是一个zip压缩文件,其中包含文件如下所示:

/**主要文件**/
classes.jar
R.txt 
AndroidManifest.xml
res/

/**其他文件**/
proguard.txt
libs/
jni/
···
AI 代码解读

 这里所谓的合并,就是就是将所有需要的aar文件内容,拷贝到一起,然后合并一个aar。当然,如何合并,合并的时机这些都是需要处理的点。而这时候, android-fat-aar 脚本,刚好满足的我们的需求。通过引入apply from: 'fat-aar.gradle' 的脚本,对需要合并模块引用修改为 embedded project(':react-native-fs') 依赖即可:

dependencies {
    embedded project(':react-native-fs')
    compile fileTree(dir: "libs", include: ["*.jar"])
    compile "com.android.support:appcompat-v7:23.0.1"
    embedded "com.facebook.react:react-native:+"  // From node_modules
}
AI 代码解读

 从脚本代码中可以知道,这里的embedded实际上是一个configuration类,而这个configurations对应的是一个 ConfigurationContainer,ConfigurationContainer包含有dependencies,如下代码所示,最终还是使用compile引用,但是这个过程中,我们通过embedded统计到哪些包需要合并发布。

configurations { 
    embedded  
}
dependencies {
    compile configurations.embedded
}
AI 代码解读

 因此我们可以根据build目录下的一些文件,动态的embedded的module进行文件拷贝和合并,如$build_dir/intermediates/exploded-aar目录下,对每个需要合并的module的res文件夹、libs文件夹、jars文件夹、assets文件夹等的拷贝。合并aar的流程如下图所示,有兴趣的可以深入了解: fat-aar-implementation-analysis

图片来自http://www.huahuaxie.com/fat-aar-implementation-analysis

 最后我们可以先在rn-library执行../gradlew assembleRelease,让react脚本生成我们需要的资源文件,然后再引用publish.gradle发布aar到maven即可。

四、最后

 如何,最终实现过程其实并不复杂,总结起来:

  • 创建一个android.library
  • 添加本地dependencies依赖
  • apply react.gradle 、 fat-aar.gradle、publish.gradle
  • 在library通过../gradlew assembleRelease打包,然后通过maven-publish执行publish上传。
Over(~ ̄▽ ̄)~

资源推荐:

哦嘞嘞

carguo
+关注
目录
打赏
0
0
0
0
10
分享
相关文章
【03】微信支付商户申请下户到配置完整流程-微信开放平台创建APP应用-填写上传基础资料-生成安卓证书-获取Apk签名-申请+配置完整流程-优雅草卓伊凡
【03】微信支付商户申请下户到配置完整流程-微信开放平台创建APP应用-填写上传基础资料-生成安卓证书-获取Apk签名-申请+配置完整流程-优雅草卓伊凡
136 28
【03】微信支付商户申请下户到配置完整流程-微信开放平台创建APP应用-填写上传基础资料-生成安卓证书-获取Apk签名-申请+配置完整流程-优雅草卓伊凡
布谷一对一直播源码android版环境配置流程及功能明细
部署需基于 CentOS 7.9 系统,硬盘不低于 40G,使用宝塔面板安装环境,包括 PHP 7.3(含 Redis、Fileinfo 扩展)、Nginx、MySQL 5.6、Redis 和最新 Composer。Swoole 扩展需按步骤配置。2021.08.05 后部署需将站点目录设为 public 并用 ThinkPHP 伪静态。开发环境建议 Windows 操作系统与最新 Android Studio,基础配置涉及 APP 名称修改、接口域名更换、包名调整及第三方登录分享(如 QQ、微信)的配置,同时需完成阿里云与腾讯云相关设置。
当flutter react native 等混开框架-并且用vscode-idea等编译器无法打包apk,打包安卓不成功怎么办-直接用android studio如何打包安卓apk -重要-优雅草卓伊凡
当flutter react native 等混开框架-并且用vscode-idea等编译器无法打包apk,打包安卓不成功怎么办-直接用android studio如何打包安卓apk -重要-优雅草卓伊凡
114 36
当flutter react native 等混开框架-并且用vscode-idea等编译器无法打包apk,打包安卓不成功怎么办-直接用android studio如何打包安卓apk -重要-优雅草卓伊凡
【Android】网络技术知识总结之WebView,HttpURLConnection,OKHttp,XML的pull解析方式
本文总结了Android中几种常用的网络技术,包括WebView、HttpURLConnection、OKHttp和XML的Pull解析方式。每种技术都有其独特的特点和适用场景。理解并熟练运用这些技术,可以帮助开发者构建高效、可靠的网络应用程序。通过示例代码和详细解释,本文为开发者提供了实用的参考和指导。
70 15
Android调试终极指南:ADB安装+多设备连接+ANR日志抓取全流程解析,覆盖环境变量配置/多设备调试/ANR日志分析全流程,附Win/Mac/Linux三平台解决方案
ADB(Android Debug Bridge)是安卓开发中的重要工具,用于连接电脑与安卓设备,实现文件传输、应用管理、日志抓取等功能。本文介绍了 ADB 的基本概念、安装配置及常用命令。包括:1) 基本命令如 `adb version` 和 `adb devices`;2) 权限操作如 `adb root` 和 `adb shell`;3) APK 操作如安装、卸载应用;4) 文件传输如 `adb push` 和 `adb pull`;5) 日志记录如 `adb logcat`;6) 系统信息获取如屏幕截图和录屏。通过这些功能,用户可高效调试和管理安卓设备。
React音频播放器样式自定义全解析:从入门到避坑指南
在React中使用HTML5原生<audio>标签时,开发者常面临视觉一致性缺失、样式定制局限和交互体验割裂等问题。通过隐藏原生控件并构建自定义UI层,可以实现完全可控的播放器视觉风格,避免状态不同步等典型问题。结合事件监听、进度条拖拽、浏览器兼容性处理及性能优化技巧,可构建高性能、可维护的音频组件,满足跨平台需求。建议优先使用成熟音频库(如react-player),仅在深度定制需求时采用原生方案。
76 12
【08】flutter完成屏幕适配-重建Android,增加GetX路由,屏幕适配,基础导航栏-多版本SDK以及gradle造成的关于fvm的使用(flutter version manage)-卓伊凡换人优雅草Alex-开发完整的社交APP-前端客户端开发+数据联调|以优雅草商业项目为例做开发-flutter开发-全流程-商业应用级实战开发-优雅草Alex
【08】flutter完成屏幕适配-重建Android,增加GetX路由,屏幕适配,基础导航栏-多版本SDK以及gradle造成的关于fvm的使用(flutter version manage)-卓伊凡换人优雅草Alex-开发完整的社交APP-前端客户端开发+数据联调|以优雅草商业项目为例做开发-flutter开发-全流程-商业应用级实战开发-优雅草Alex
227 20
【08】flutter完成屏幕适配-重建Android,增加GetX路由,屏幕适配,基础导航栏-多版本SDK以及gradle造成的关于fvm的使用(flutter version manage)-卓伊凡换人优雅草Alex-开发完整的社交APP-前端客户端开发+数据联调|以优雅草商业项目为例做开发-flutter开发-全流程-商业应用级实战开发-优雅草Alex
【02】仿站技术之python技术,看完学会再也不用去购买收费工具了-本次找了小影-感觉页面很好看-本次是爬取vue需要用到Puppeteer库用node.js扒一个app下载落地页-包括安卓android下载(简单)-ios苹果plist下载(稍微麻烦一丢丢)-优雅草卓伊凡
【02】仿站技术之python技术,看完学会再也不用去购买收费工具了-本次找了小影-感觉页面很好看-本次是爬取vue需要用到Puppeteer库用node.js扒一个app下载落地页-包括安卓android下载(简单)-ios苹果plist下载(稍微麻烦一丢丢)-优雅草卓伊凡
91 7
【02】仿站技术之python技术,看完学会再也不用去购买收费工具了-本次找了小影-感觉页面很好看-本次是爬取vue需要用到Puppeteer库用node.js扒一个app下载落地页-包括安卓android下载(简单)-ios苹果plist下载(稍微麻烦一丢丢)-优雅草卓伊凡
【09】flutter首页进行了完善-采用android studio 进行真机调试开发-增加了直播间列表和短视频人物列表-增加了用户中心-卓伊凡换人优雅草Alex-开发完整的社交APP-前端客户端开发+数据联调|以优雅草商业项目为例做开发-flutter开发-全流程-商业应用级实战开发-优雅草Alex
【09】flutter首页进行了完善-采用android studio 进行真机调试开发-增加了直播间列表和短视频人物列表-增加了用户中心-卓伊凡换人优雅草Alex-开发完整的社交APP-前端客户端开发+数据联调|以优雅草商业项目为例做开发-flutter开发-全流程-商业应用级实战开发-优雅草Alex
74 4
【09】flutter首页进行了完善-采用android studio 进行真机调试开发-增加了直播间列表和短视频人物列表-增加了用户中心-卓伊凡换人优雅草Alex-开发完整的社交APP-前端客户端开发+数据联调|以优雅草商业项目为例做开发-flutter开发-全流程-商业应用级实战开发-优雅草Alex
React音频播放控制组件开发深度解析
本文介绍了构建React音频控制组件时遇到的关键问题及优化方案。主要包括: 1. **状态同步难题**:解决播放按钮与音频状态不同步的问题,通过双向绑定机制确保一致。 2. **跨浏览器兼容性**:处理Safari和Chrome预加载策略差异,确保`duration`属性正确获取。 3. **进度控制优化**:避免使用`setInterval`,采用`requestAnimationFrame`提升性能;优化拖拽交互,防止音频卡顿。 4. **音量控制进阶**:实现渐变音量调节和静音状态同步。
85 15

推荐镜像

更多
AI助理

你好,我是AI助理

可以解答问题、推荐解决方案等