React Native调用原生UI组件

2018-02-06 17:28:17 浏览数 (1)

在React Native 中,其已经将几个常用的原生组件进行了封装,但是并不是所有系统的原始组件都被封装了,因此有时候我们不得不自己动手封装一下,从而能够使用那些React Native没有为我们封装的原生组件。为了方便讲解,我们选择第一个第三方库kenburnsview来讲解,kenburnsview是一个可以让图片在在页面移动或者放大缩小的库。

Android原生组件封装

1,继承SimpleViewManager,返回UI组件实例 首先,需要继承 SimpleViewManager 这个泛型类,和原生模块类似,需要重写 getName() 方法,将UI组件名称暴露给javascript层,接着需要重写 createViewInstance 方法,在里面返回需要使用的原生UI组件的实例。 2,暴露接口给javascript层调用 然后,就是暴露一些必要属性给javascript层,为了简单起见,我们这里只暴露两个属性,一个是 url ,一个是 html ,一旦javascript层设置了url,就会加载一个网页,而一旦设置了html,则会去加载这段html,而属性的暴露是使用注解。 为了方便,提供对应的set方法,之后在set方法中处理UI的更新操作。

代码实现

首先看一下效果: 首先新建一个RN项目,使用Anroid Studio开的Android项目,在build.gradle中添加kenburnsview库。

代码语言:javascript复制
compile 'com.flaviofaria:kenburnsview:1.0.7'

编写原生KenBurnsViewManager类,主要封装KenBurnsView的相关逻辑。代码如下:

代码语言:javascript复制
package com.rndemos;

import android.graphics.drawable.Drawable;
import android.support.annotation.Nullable;
import android.util.Log;
import android.webkit.WebView;
import android.webkit.WebViewClient;

import com.facebook.react.uimanager.SimpleViewManager;
import com.facebook.react.uimanager.ThemedReactContext;
import com.facebook.react.uimanager.annotations.ReactProp;
import com.flaviofaria.kenburnsview.KenBurnsView;

import java.io.InputStream;


/**
 * Created by xiangzhihong on 2017/7/2.
 * React Native调用原生的Webiew组件
 */

public class KenBurnsViewManager extends SimpleViewManager<KenBurnsView> {

    public static final String REACT_CLASS = "KenBurnsView";
    private ThemedReactContext mContext=null;

    @Override
    public String getName() {
        return REACT_CLASS;
    }

    @Override
    protected KenBurnsView createViewInstance(ThemedReactContext reactContext) {
        mContext=reactContext;
        KenBurnsView kView= new KenBurnsView(reactContext);
        try {
            InputStream in=mContext.getAssets().open("shanghai.png");
            Drawable drawable=Drawable.createFromStream(in,null);
            kView.setImageDrawable(drawable);
        }catch (Exception e){
            e.printStackTrace();
        }
        return kView;
    }

    @ReactProp(name = "imageSource")
    public void setSource(KenBurnsView view,@Nullable String imagePath) {
        try {
            InputStream in=mContext.getAssets().open(imagePath);
            Drawable drawable=Drawable.createFromStream(in,null);
            view.setImageDrawable(drawable);
        }catch (Exception e){
            e.printStackTrace();
        }
    }
}

实现ReactPackage接口,在createNativeModules函数中添加我们自定义的模块。该类的基本作用就是把继承的类的方法注册到JS里。相关代码如下:

代码语言:javascript复制
package com.rndemos;

import com.facebook.react.ReactPackage;
import com.facebook.react.bridge.JavaScriptModule;
import com.facebook.react.bridge.NativeModule;
import com.facebook.react.bridge.ReactApplicationContext;
import com.facebook.react.uimanager.ViewManager;

import java.util.ArrayList;
import java.util.Collections;
import java.util.List;

/**
 * Created by xiangzhihong on 2017/7/2.
 * 原生UI管理类
 */

public class KenBurnsViewPackage implements ReactPackage {

    @Override
    public List<NativeModule> createNativeModules(ReactApplicationContext reactContext) {
        List<NativeModule> modules = new ArrayList<>();
        modules.add(new KenBurnsViewManager());
        return modules;
    }

    @Override
    public List<ViewManager> createViewManagers(ReactApplicationContext reactContext) {
        return Collections.emptyList();
    }

    @Override
    public List<Class<? extends JavaScriptModule>> createJSModules() {
        return Collections.emptyList();
    }
}

熟悉原生模块的开发人员都知道,新建一个组件需要向系统注册。添加AppReactPackage 到ReactInstanceManager的实例中去,这里需要向MainActivity注册我们新建的组件(这是老版本的写法,新版本在Application注册)。MainActivity代码如下:

代码语言:javascript复制
package com.rndemos;

import android.app.Application;

import com.facebook.react.ReactApplication;
import com.facebook.react.ReactInstanceManager;
import com.facebook.react.ReactNativeHost;
import com.facebook.react.ReactPackage;
import com.facebook.react.ReactRootView;
import com.facebook.react.common.LifecycleState;
import com.facebook.react.shell.MainReactPackage;
import com.facebook.soloader.SoLoader;

import java.util.Arrays;
import java.util.List;

import static com.facebook.react.common.ApplicationHolder.getApplication;

public class MainApplication extends Application implements ReactApplication {


  private ReactRootView mReactRootView;
  private ReactInstanceManager mReactInstanceManager;

  private final ReactNativeHost mReactNativeHost = new ReactNativeHost(this) {
    @Override
    public boolean getUseDeveloperSupport() {
      return BuildConfig.DEBUG;
    }

    @Override
    protected List<ReactPackage> getPackages() {
      return Arrays.<ReactPackage>asList(
          new MainReactPackage()
      );
    }
  };

  @Override
  public ReactNativeHost getReactNativeHost() {
    return mReactNativeHost;
  }

  @Override
  public void onCreate() {
    super.onCreate();
    SoLoader.init(this, /* native exopackage */ false);
    initReactInstance();
  }
   //添加的代码
  //添加AppReactPackage 到ReactInstanceManager的实例中去
  public void initReactInstance(){
    mReactRootView = new ReactRootView(this);
    mReactInstanceManager = ReactInstanceManager.builder()
            .setApplication(getApplication())
            .setBundleAssetName("index.android.bundle")
            .setJSMainModuleName("index.android")
            .addPackage(new MainReactPackage())
            .addPackage(new AppReactPackage())
            .setUseDeveloperSupport(BuildConfig.DEBUG)
            .setInitialLifecycleState(LifecycleState.RESUMED)
            .build();

  }
}

不过需要注意的是0.41版本之后,注册组件的方法改到了Application。在Application中找到getPackages方法,然后加如下代码。

代码语言:javascript复制
 protected List<ReactPackage> getPackages() {
      return Arrays.<ReactPackage>asList(
          new MainReactPackage(),
          new AppReactPackage()
      );
    }

React Native实现

接下来,我们需要在javascript层新建一个js文件(ReactWebView,区分系统的WebView)。注意,在与index.android.js相同的目录下创建。KenBurnsView类相关代码如下:

代码语言:javascript复制
import React, { Component,PropTypes } from 'react';
import {
    requireNativeComponent,
    NativeModules,
     View
} from 'react-native';

var iface = {
    name: 'KenBurnsView',
    propTypes: {
        imageSource: React.PropTypes.string,
        ...View.propTypes
    },
};

module.exports = requireNativeComponent('KenBurnsView', iface);

然后在Android中调用:

代码语言:javascript复制
var KenBurnView=require('./KenBurnsView');

let {width, height} = Dimensions.get("window");

export default class RNDemos extends Component {
    render() {
        return (
            <KenBurnView style={styles.imageStyle} imageSource='http://ohe65w0xx.bkt.clouddn.com/shanghai.png'/>
        );
    }
}

不过调用貌似有点问题。

0 人点赞