React Native for Android 热部署图片自己定义方案

情景

热部署时，我们期望升级包中包括js代码与图片资源。

bundle的热部署网上已经有两种方案了，一种是用反射，一种是利用RN自带函数。将bundle初始化时直接放到指定文件夹下，之后通过替换bundle文件实现代码热部署。

我们希望图片也能够实现热部署，以下是一个比較简单的解决方式。

详细需求：client解析从server下发的压缩包(zip)，当中含js源文件index.android.bundle 和图片包，解压后ReactNative指向解压后index.android.bundle中的js代码，js代码中使用的图片资源指向

解压后的图片资源。(data/data/files/或sdcard里)

client依据执行场景 debug or release 决定从server 或者本地解压文件夹获取图片资源，也就是一个url兼容在不同场景下訪问不同资源。

Image 使用演示样例

//1.请求react native server的图片
<Image source={require('./image/help.png')} style={styles.helpImage}/>
//2.请求网络的图片
<Image source={uri:'http://xxxxxx/image/help.png'} style={styles.helpImage}/>
//3.请求native图片
<Image source={{uri:'help'}} style={styles.helpImage}/>
//4.请求手机指定路径图片
<Image source={{uri:'file:///sdcard/help.png'}}

上面两种都会发送网络请求

期望:本地开发时，图片来自1，上线后，图片来自4.为了让两者在代码形式上一致

须要自己定义协议：http-cage://xxx/xxx.png 类似这样的形式，在不同环境下获取不同路径的图片。

Image载入资源机制

涉及类：

js: RCTImage.js, AssetRegistry.js,resolveAssetSource.js,Image.android.js，AssetRegistry.js

Native:ReactImageView.java

调用顺序关系：

1:遍历检測使用外部资源(比方RNserver上的图片)。检測到一处调用AssetRegistry

2:AssetRegistry.registerAsset

将资源增加到AssetRegistry的assets数组中，将id返回,也就是资源在assets中的索引值。

3 检測到<Image 标签触发 Image.android.js render

4:resolveAssetSource.resolveAssetSource(source)

source可能是object类型，封装了图片url。或者是number类型。也就是资源id，id值由步骤2 决定。

5: 推断资源类型

object：非本地资源（网络、sdcard、apk中图片）跳6

number: 资源id (RNserver) 跳7

6: return object 跳10

7: 依据id从AssetRegistry的assets中取出资源asset。

 var asset = AssetRegistry.getAssetByID(source);

8:拼接资源路径

1.获取RNserver地址

  var devServerURL = getDevServerURL(); //获取RN server地址。 通常是 http://localhost:8081/

2.取到server地址，依据地址与asset中的路径拼接，"http://localhost:8081/assets/image/open.png?

platform=android&hash=ff54b39af9b07e7380a4eda7e0212643"

3.取不到server地址，从压缩包中获得地址 getPathInArchive。

地址返回。9

9: 依据url 构建和 6类似的object

function assetToImageSource(asset): ResolvedAssetSource {
  var devServerURL = getDevServerURL();
  return {
    __packager_asset: true,
     asset.width,
    height: asset.height,
    uri: devServerURL ? getPathOnDevserver(devServerURL, asset) : getPathInArchive(asset),
    scale: pickScale(asset.scales, PixelRatio.get()),
  };
}

10:Image.android.js 收到 object，与 NativeProps合并，

var nativeProps = merge(this.props, {
        style,
        src: source.uri,
      });

11:合并后的NativeProps传入 RCTImage

12: RCTImage解析NativeProps将uri传给java的ReactImageView.java setSource

协议自己定义方案

在11到12之间进行协议推断。改动Image.android.js文件及resolveAssetSource.js。

Image.android.js
 
 render: function() {
...
var prefix = 'http-cage://';
          var match = nativeProps.src.indexOf(prefix);
          if(match == 0){//以http-cage://开头
             console.log(__DEV__);
             var realUrl = nativeProps.src.substring(prefix.length,nativeProps.src.length);
             if(debug){//debug 情况  RN server：http://10.0.3.5:8081/assets/image/help.png
                 nativeProps.src = resolveAssetSource.getDevServerURL()+realUrl;
             }else {//release 情况 图片路径：file:///sdcard/image/help.png
                 nativeProps.src = 'file://'+'/sdcard/'+realUrl;
             }
 }
}

resolveAssetSource.js
 
//使 getDevServerURL 外部可用
module.exports.getDevServerURL = getDevServerURL;

自己定义协议使用演示样例

//測试版本号0.13.2

0.14開始图片放到根文件夹 img文件下而且在js中被require，~~就会被打入bundle中。压缩比非常夸张，不知道用了什么压缩算法。~~

<Image source={require('./img/help.png')} style={styles.helpImage}/>

后记

经同事验证，img目录下的图片被打到了apk的res中去，之前误导大家了，sorry