React Native Application和Activity源码分析

基于V0.43.3版本 React Native Android端的ReactApplication和ReactActivity的实现原理.

ReactApplication

在Android端接入RN时,需要ReactApplication作为接口被Application实现. 从源码中可以看出ReactApplication只是提供了一个获取实现ReactNativeHost的接口. 这个类既然叫Host那么肯定承载了RN的实例和一些配置,可以通过下面的类图或源码看出它都有什么职责.

点击查看大图

从类图中可以看到RNHost中持有着Application的对象,这个很好理解,因为RN初始化一些部件或读取一些资源的时候肯定会需要用到Application. 而另外一个属性就是核心的ReactInstanceManager,RNHost类中的方法都是为InstanceManager服务的. R通过ReactInstanceManager管理配置负责Java和JS通讯的高层API类CatalystInstance,dev support的支持,并且绑定并同步与ReactRootView所在容器的声明周期. 下面简单看一下Host类对ReactInstanceManager配置和初始化的10个方法.

1. getReactInstanceManager方法

   public ReactInstanceManager getReactInstanceManager() {
       if (mReactInstanceManager == null) {
           mReactInstanceManager = createReactInstanceManager();
       }
       return mReactInstanceManager;
   }

   获取当前Host对象持有的ReactInstanceManager对象,如果还没有创建的话就通过create方法初始化ReactInstanceManager对象. 因为都是在同一个线程中调用该方法,所以这种懒加载的初始化方式不会有线程安全问题.

2. hasInstance方法

   public boolean hasInstance() {
       return mReactInstanceManager != null;
   }

   判断当前ReactInstanceManager对象有没有实例化.

3. getRedBoxHandler方法

   protected @Nullable RedBoxHandler getRedBoxHandler() {
       return null;
   }

   该方法用于初始化ReactInstanceManager对象实例,根据实际情况选择复写该方法. RedBoxHandler提供运行时JS异常之后的交互,默认情况下会有红色的页面出现并显示出JS异常的堆栈信息,应该就是这个原因才叫RedBox吧. 复写该方法可以自定义一些JS异常之后的流程来丰富产品的兼容交互.

4. getUIImplementationProvider方法

   protected UIImplementationProvider getUIImplementationProvider() {
       return new UIImplementationProvider();
   }

   该方法用法同上. 如果想要定制RN UI方面的话可以选择复写该方法,源码中说这个部件是一个非常高级的定制功能,使用默认的初始化就可以满足百分之九十九的场景,如无必要不建议复写该方法.

5. getJSMainModuleName方法

   protected String getJSMainModuleName() {
       return "index.android";
   }

   该方法用法同上. 设置js中的模块名称,这样就可以在开启了DevSupport的情况下直接加载 packager server上的js bundle中的模块. 在DevSupport下加载的优先级是比较高的.

6. getJSBundleFile方法

   protected @Nullable String getJSBundleFile() {
       return null;
   }

   该方法用法同上. 如果有在自定义路径下(sd卡或者app沙盒控件)加载js bundle文件的需求的话就要重写该方法并制定要加载的文件路径. 如果使用默认配置的话RN优先根据下面的方法从assets路径下拿js bundle文件.

7. getBundleAssetName方法

   protected @Nullable String getBundleAssetName() {
       return "index.android.bundle";
   }

   该方法用法同上. 如果开启了DevSupport,RN会优先通过pack server远程加载js bundle文件. 然而在没有开启DevSupport并且没有复写6方法制定特定路径的情况下,RN会根据该方法配置的bundle文件名在assets下读取并加载该文件.

8. getUseDeveloperSupport方法

   public abstract boolean getUseDeveloperSupport();

   该方法用法同上. getUseDeveloperSupport是一个虚方法. 通过它可以配置是否开启RN的DevSupport.

9. getPackages方法

   protected abstract List<ReactPackage> getPackages();

   该方法用法同上. getPackages方法也是一个虚方法,使用该方法来设置RN中JS和Native之间相互的通信模块,自定义View的接口和Native本地资源的接口. 列表中最少要包含ReactPackage 的系统实现MainReactPackage对象,如果项目使用到了自定的native module,js module和view managers 要将其添加到ReactPackage列表中.

10. createReactInstanceManager方法

    protected ReactInstanceManager createReactInstanceManager() {
        ReactInstanceManagerBuilder builder = ReactInstanceManager.builder()
          .setApplication(mApplication)
          .setJSMainModuleName(getJSMainModuleName())
          .setUseDeveloperSupport(getUseDeveloperSupport())
          .setRedBoxHandler(getRedBoxHandler())
          .setUIImplementationProvider(getUIImplementationProvider())
          .setInitialLifecycleState(LifecycleState.BEFORE_CREATE);
    
        for (ReactPackage reactPackage : getPackages()) {
          builder.addPackage(reactPackage);
        }
    
        String jsBundleFile = getJSBundleFile();
        if (jsBundleFile != null) {
          builder.setJSBundleFile(jsBundleFile);
        } else {
          builder.setBundleAssetName(Assertions.assertNotNull(getBundleAssetName()));
        }
        return builder.build();
    }

    讲过上面七个参与ReactInstanceManager对象初始化的方法之后,通过Builder的形式在createReactInstanceManager方法中将初始化所需的配置信息汇总起来并对ReactInstanceManager进行初始化操作.

ReactActivity

RN源码中有提供两个可以直接使用的Activity,分别是ReactActivity和ReactFragmentActivity. 他们两个的差别是分别继承自Activity和FragmentActivity. 对RN来说没有太大的区别,这里就只分析ReactActivity了. 并且可以通过对ReactActivity的分析,再结合RN的设计就可以自己封装出来类似ReactFragment之类的组件出来.

点击查看大图

从ReactActivity相关的类图可以看到它实现了两个接口,分别是用来将Android回退键点击事件代理给JS的DefaultHardwareBackBtnHandler 和 处理运行时权限授权申请和回调的PermissionAwareActivity. 除了这两个接口之外,ReactActivity还有一个ReactActivityDelegate的属性. 通过源码可以看到这个对象把ReactActivity的声明周期,事件和权限管理相关全部都同步并代理到自己内部.

通过getMainComponentName方法指定在JS中注册的主模块名称,并且在构造方法里对delegate对象进行初始化. 如果有特殊需求的话例如要向JS的主模块中传递一些数据等,可以选择复写createReactActivityDelegate方法,使用定制的ReactActivityDelegate子类进行初始化.

protected ReactActivity() {
    mDelegate = createReactActivityDelegate();
}

protected @Nullable String getMainComponentName() {
    return null;
}

protected ReactActivityDelegate createReactActivityDelegate() {
    return new ReactActivityDelegate(this,getMainComponentName());
}

经过上面的分析,ReactActivity其实就是一个代理行为的空壳,真正的实现都在ReactActivityDelegate中. 接下来就进入类中看这个代理类究竟做了什么.首先看一下构造方法.由于ReactActivity和ReactFragmentActivity都使用了相同的Delegate类,所以提供了两个不同的构造接受Activity的实例和js端注册的模块名称.

public ReactActivityDelegate(Activity activity,@Nullable String mainComponentName) {
    mActivity = activity;
    mMainComponentName = mainComponentName;
    mFragmentActivity = null;
}

public ReactActivityDelegate(FragmentActivity fragmentActivity,@Nullable String mainComponentName) {
    mFragmentActivity = fragmentActivity;
    mMainComponentName = mainComponentName;
    mActivity = null;
}

接下来看到有两个提供被代理方Context和Activity的方法,方便内部使用.

private Context getContext() {
    if (mActivity != null) {
      return mActivity;
    }
    return Assertions.assertNotNull(mFragmentActivity);
}

private Activity getPlainActivity() {
    return ((Activity) getContext());
}

往下看就能发现在上面讲ReactApplication的时候主要涉及到的两个类. Application只是提供了一个getReactNativeHost的方法,它本身并没有调用该方法对ReactInstanceManager进行初始化,上面一节有说过ReactInstanceManager是懒加载初始化的,从这看来ReactInstanceManager初始化的时机就是打开RN页面之后,在RN页面装载的过程中对其初始化.

protected ReactNativeHost getReactNativeHost() {
    return ((ReactApplication) getPlainActivity().getApplication()).getReactNativeHost();
}

public ReactInstanceManager getReactInstanceManager() {
    return getReactNativeHost().getReactInstanceManager();
}

其他的方法例如 onResume,onPause,onDestroy,onActivityResult,onKeyUp,onBackPressed,onNewIntent,requestPermissions和onRequestPermissionsResult方法将声明周期同步到ReactInstanceManager中,点击/回退与devSupport事件相关联,动态权限申请和回调的管理起来,这里就不一一细说了. 除此之外onDestroy方法触发的时候还会根据情况将rootView从ReactInstanceManager对象中卸载掉.

protected void onDestroy() {
    if (mReactRootView != null) {
        mReactRootView.unmountReactApplication();
        mReactRootView = null;
    }
    if (getReactNativeHost().hasInstance()) {
        getReactNativeHost().getReactInstanceManager().onHostDestroy(getPlainActivity());
    }
}

单独分析一下onCreate方法,第一个大的if块是对DrawOverlays权限的判断. 因为从Android 6.0开始悬浮窗权限收紧,RN对该权限做了判断,如果没有DrawOverlays权限的话就跳转到系统设置页面动态申请. 有权限了之后就会调用loadApp方法,对RootView进行初始化. 最后初始化了一个双击R键的监听器,服务于Dev Support.

protected void onCreate(Bundle savedInstanceState) {
    boolean needsOverlayPermission = false;
    if (getReactNativeHost().getUseDeveloperSupport() && Build.VERSION.SDK_INT >= Build.VERSION_CODES.M) {
      // Get permission to show redbox in dev builds.
      if (!Settings.canDrawOverlays(getContext())) {
        needsOverlayPermission = true;
        Intent serviceIntent = new Intent(Settings.ACTION_MANAGE_OVERLAY_PERMISSION,Uri.parse("package:" + getContext().getPackageName()));
        FLog.w(ReactConstants.TAG,REDBOX_PERMISSION_MESSAGE);
        Toast.makeText(getContext(),REDBOX_PERMISSION_MESSAGE,Toast.LENGTH_LONG).show();
        ((Activity) getContext()).startActivityForResult(serviceIntent,REQUEST_OVERLAY_PERMISSION_CODE);
      }
    }

    if (mMainComponentName != null && !needsOverlayPermission) {
      loadApp(mMainComponentName);
    }
    mDoubleTapReloadRecognizer = new DoubleTapReloadRecognizer();
}

loadApp方法其实就是对RootView的初始化,并通过rootView的startReactApplication方法将其装载进ReactInstanceManager进行管理,与onDestroy方法中的unmountReactApplication相对应. 因为RootView就是一个view,将其装载进acitivty中就可以绘制出来. 后面会单独分析ReactRootView.

protected ReactRootView createRootView() {
    return new ReactRootView(getContext());
}

protected void loadApp(String appKey) {
    if (mReactRootView != null) {
        throw new IllegalStateException("Cannot loadApp while app is already running.");
    }
    mReactRootView = createRootView();
    mReactRootView.startReactApplication(
      getReactNativeHost().getReactInstanceManager(),appKey,getLaunchOptions());

    getPlainActivity().setContentView(mReactRootView);
}

转载请注明出处:http://www.52php.cn/article/p-ebyyshjg-bpo.html