Android集成weex汇总

weex指北针

集成环境

IDE Android studio v3.1.2
JDK jdk1.8

根据文档说明，我一路next走下来，发现并不能正常跑起来，经baidu，google，github后，整理出一套完整的集成步骤；

 

首先说一下文档上的内容

1、app module下添加依赖（我的targetSdkVersion 28 ）

   

 implementation 'org.apache.weex:sdk:0.28.0'
        // fastjson
    implementation 'com.alibaba:fastjson:1.1.46.android'

        //support library dependencies
     implementation 'com.android.support:recyclerview-v7:27.1.1'
     implementation 'com.android.support:support-v4:27.1.1'
     implementation 'com.android.support:appcompat-v7:28+'

2、app androidManifast 添加权限

//网络
<uses-permission android:name="android.permission.INTERNET"/>
<uses-permission android:name="android.permission.ACCESS_NETWORK_STATE"/>

//sd卡读写
<uses-permission android:name="android.permission.WRITE_EXTERNAL_STORAGE"/>
<uses-permission android:name="android.permission.READ_EXTERNAL_STORAGE"/>

此时先省略混淆方案

3、初始化SDK

InitConfig config = new InitConfig.Builder().build();
WXSDKEngine.initialize(applicationContext,config);

4、初始化WXSDKInstance 的 MainActivity代码

 

public class MainActivity extends AppCompatActivity implements IWXRenderListener {
  WXSDKInstance mWXSDKInstance;
  @Override
  protected void onCreate(Bundle savedInstanceState) {
    super.onCreate(savedInstanceState);
    setContentView(R.layout.activity_main);
    mWXSDKInstance = new WXSDKInstance(this);
    mWXSDKInstance.registerRenderListener(this);
    /**
    * bundleUrl source http://dotwe.org/vue/38e202c16bdfefbdb88a8754f975454c
    */
    String pageName = "WXSample";
    String bundleUrl = "http://dotwe.org/raw/dist/38e202c16bdfefbdb88a8754f975454c.bundle.wx";
    mWXSDKInstance.renderByUrl(pageName, bundleUrl, null, null,WXRenderStrategy.APPEND_ASYNC);
  }
  @Override
  public void onViewCreated(WXSDKInstance instance, View view) {
    setContentView(view);
  }
  @Override
  public void onRenderSuccess(WXSDKInstance instance, int width, int height) {
  }
  @Override
  public void onRefreshSuccess(WXSDKInstance instance, int width, int height) {
  }
  @Override
  public void onException(WXSDKInstance instance, String errCode, String msg) {
  }
  @Override
  protected void onResume() {
    super.onResume();
    if(mWXSDKInstance!=null){
      mWXSDKInstance.onActivityResume();
    }
  }
  @Override
  protected void onPause() {
    super.onPause();
    if(mWXSDKInstance!=null){
       mWXSDKInstance.onActivityPause();
    }
  }
  @Override
  protected void onStop() {
    super.onStop();
    if(mWXSDKInstance!=null){
      mWXSDKInstance.onActivityStop();
    }
  }
  @Override
  protected void onDestroy() {
    super.onDestroy();
    if(mWXSDKInstance!=null){
      mWXSDKInstance.onActivityDestroy();
    }
  }
}

WXSDKInstance是weex渲染页面的基本单元，此时注册了渲染监听，添加了视图.

到此时按照文档说明，应该是可以运行了，运行结果是  Hello World

run app.....
但是运行的结果 是一片空白

IWXRenderListener的方法 onException执行结果打印如下：

 -1001//degradeToH5|createInstance fail|wx_create_instance_error isJSFrameworkInit==false reInitCount == 1

可以看出创建weex实例失败

此时我是一脸懵牛逼，作为官方文档，居然跑不通，简直匪夷所思。

5、查看一下源码：
WEEXSDK 初始化的方法

 

WXSDKEngine.initialize(MyWeex.this,config);

/**
   *
   * @param application
   * @param config initial configurations or null
   */
  public static void initialize(Application application,InitConfig config){
    synchronized (mLock) {
      if (mIsInit) {
        return;
      }
      long start = System.currentTimeMillis();
      WXEnvironment.sSDKInitStart = start;
      if(WXEnvironment.isApkDebugable(application)){
        WXEnvironment.sLogLevel = LogLevel.DEBUG;
      }else{
        WXEnvironment.sLogLevel = LogLevel.WARN;
      }
      doInitInternal(application,config);
      registerApplicationOptions(application);
      WXEnvironment.sSDKInitInvokeTime = System.currentTimeMillis()-start;
      WXLogUtils.renderPerformanceLog("SDKInitInvokeTime", WXEnvironment.sSDKInitInvokeTime);
      mIsInit = true;
    }
  }


 private static void doInitInternal(final Application application,final InitConfig config){
    WXEnvironment.sApplication = application;
    if(application == null){
      WXLogUtils.e(TAG, " doInitInternal application is null");
      WXExceptionUtils.commitCriticalExceptionRT(null,
              WXErrorCode.WX_KEY_EXCEPTION_SDK_INIT,
              "doInitInternal",
              WXErrorCode.WX_KEY_EXCEPTION_SDK_INIT.getErrorMsg() + "WXEnvironment sApplication is null",
              null);
    }
    WXEnvironment.JsFrameworkInit = false;

    WXBridgeManager.getInstance().postWithName(new Runnable() {
      @Override
      public void run() {
        long start = System.currentTimeMillis();
        WXSDKManager sm = WXSDKManager.getInstance();
        sm.onSDKEngineInitialize();
        if(config != null ) {
          sm.setInitConfig(config);
        }
        WXSoInstallMgrSdk.init(application,
                sm.getIWXSoLoaderAdapter(),
                sm.getWXStatisticsListener());
        final IWXUserTrackAdapter userTrackAdapter= config!=null?config.getUtAdapter():null;
        final int version = 1;
        mIsSoInit = WXSoInstallMgrSdk.initSo(V8_SO_NAME, version, userTrackAdapter);
        WXSoInstallMgrSdk.copyJssRuntimeSo();
        if(config!=null) {
          for (String libraryName : config.getNativeLibraryList()) {
            WXSoInstallMgrSdk.initSo(libraryName, version, userTrackAdapter);
          }
        }
        if (!mIsSoInit) {
          WXExceptionUtils.commitCriticalExceptionRT(null,
                  WXErrorCode.WX_KEY_EXCEPTION_SDK_INIT,
                  "doInitInternal",
                  WXErrorCode.WX_KEY_EXCEPTION_SDK_INIT.getErrorMsg() + "isSoInit false",
                  null);
          return;
        }
        sm.initScriptsFramework(config!=null?config.getFramework():null);

        WXEnvironment.sSDKInitExecuteTime = System.currentTimeMillis() - start;
        WXLogUtils.renderPerformanceLog("SDKInitExecuteTime", WXEnvironment.sSDKInitExecuteTime);
      }
    },null,"doInitWeexSdkInternal");
    WXStateRecord.getInstance().startJSThreadWatchDog();
    register();
  }

 看到这里可以看出，初始化时异步的。还有一种说法，是ndk架构问题，而文档第一行提示：

 weex 支持
 x86
 armeabi-v7a
 arm64-v8a

    但是翻遍了文档，我也没发现在哪里下载so文件。根据这个哥们的指引，才发现是weex依赖版本问题，
由于weex 0.28.0的调整，以前版本自动引入的facebook提供的JS引擎js-android,现在被修改为需要手工引入，但是文档没有清晰的指出这个问题，导致运行的时候，会由于找不到libjsc.so而导致WXSDKEngine初始化失败。

指北针

6、添加libjsc.so文件

app module build.gradle 中添加依赖

apply from: 'https://www.mobibrw.com/wp-content/uploads/2019/11/download_jsc.gradle'

同时配置ndk架构

 ndk{
            abiFilters "armeabi-v7a", "arm64-v8a", "x86"
        }

 build project后

 还要补充一下WXSDKEngine属性和调试模式

 7、创建application 并初始化代码

 application初始化源码

 public class MyWeex extends Application {
     @Override
     public void onCreate() {
         super.onCreate();
         InitConfig config = new InitConfig.Builder()
                 .setHttpAdapter(new DefaultWXHttpAdapter()).build();
         WXSDKEngine.initialize(MyWeex.this,config);
         WXBridgeManager.updateGlobalConfig("wson_on");
         WXEnvironment.setOpenDebugLog(true);
         WXEnvironment.setApkDebugable(true);
         WXSDKEngine.addCustomOptions("appName", "WXSample");
         WXSDKEngine.addCustomOptions("appGroup", "WXApp");

     }
 }

完整的代码如下：

app  build.gradle文件

apply plugin: 'com.android.application'
apply from: 'https://www.mobibrw.com/wp-content/uploads/2019/11/download_jsc.gradle'
android {
    compileSdkVersion 28
    defaultConfig {
        applicationId "com.nade.weex"
        minSdkVersion 19
        targetSdkVersion 28
        versionCode 1
        versionName "1.0"
        testInstrumentationRunner "android.support.test.runner.AndroidJUnitRunner"
        ndk{
            abiFilters "armeabi-v7a", "arm64-v8a", "x86"
        }
    }
    buildTypes {
        release {
            minifyEnabled false
            proguardFiles getDefaultProguardFile('proguard-android.txt'), 'proguard-rules.pro'
        }
    }
}

dependencies {
    implementation fileTree(dir: 'libs', include: ['*.jar'])
    implementation 'com.android.support.constraint:constraint-layout:1.1.3'
    testImplementation 'junit:junit:4.12'
    androidTestImplementation 'com.android.support.test:runner:1.0.2'
    androidTestImplementation 'com.android.support.test.espresso:espresso-core:3.0.2'

    implementation 'org.apache.weex:sdk:0.28.0'
    // fastjson
    implementation 'com.alibaba:fastjson:1.1.46.android'

    //support library dependencies
    implementation 'com.android.support:recyclerview-v7:27.1.1'
    implementation 'com.android.support:support-v4:27.1.1'
    implementation 'com.android.support:appcompat-v7:28+'
}

MyWeex Application

 

 public class MyWeex extends Application {
     @Override
     public void onCreate() {
         super.onCreate();
         InitConfig config = new InitConfig.Builder()
                 .setHttpAdapter(new DefaultWXHttpAdapter()).build();
         WXSDKEngine.initialize(MyWeex.this,config);
         WXBridgeManager.updateGlobalConfig("wson_on");
         WXEnvironment.setOpenDebugLog(true);
         WXEnvironment.setApkDebugable(true);
         WXSDKEngine.addCustomOptions("appName", "WXSample");
         WXSDKEngine.addCustomOptions("appGroup", "WXApp");

     }
 }

MainActivity

 public class MainActivity extends AppCompatActivity implements IWXRenderListener {

     private WXSDKInstance wxsdkInstance;
     private Handler handler = new Handler(){
         @Override
         public void handleMessage(Message msg) {
             super.handleMessage(msg);
             /**
              * 轮询访问 WXSDKEngine 初始化状态 防止异步造成的初始化失败问题
              */
             if (msg.what == 1) {
                 if (WXSDKEngine.isInitialized()) {
                     startRender();
                 }else {
                     handler.sendEmptyMessageDelayed(1,300);
                 }
             }
         }
     };
     @Override
     protected void onCreate(Bundle savedInstanceState) {
         super.onCreate(savedInstanceState);


         wxsdkInstance = new WXSDKInstance(this);
         wxsdkInstance.registerRenderListener(this);
         if (WXSDKEngine.isInitialized()) {
             startRender();
         }else {
             handler.sendEmptyMessageDelayed(1,300);
         }

     }

     /**
      * WXSDKEngine 初始化成功后 开始渲染
      */
     private void startRender() {
         String pageName = "WXSample";
         /**
          * 防止空指针
          */
         if (wxsdkInstance == null) {
             wxsdkInstance = new WXSDKInstance(this);
             wxsdkInstance.registerRenderListener(this);
         }

         /**
          * 渲染远程js
          */
         String bundleUrl = "http://dotwe.org/raw/dist/38e202c16bdfefbdb88a8754f975454c.bundle.wx";
         wxsdkInstance.renderByUrl(pageName, bundleUrl, null, null, WXRenderStrategy.APPEND_ASYNC);

         /**
          * 渲染本地js
          */
      //   String bundleUrl = "index.js";
      //   wxsdkInstance.render(pageName, WXFileUtils.loadAsset(bundleUrl,this), null, null, WXRenderStrategy.APPEND_ASYNC);
     }

     /**
      * 重写生命周期方法
      */
     @Override
     protected void onResume() {
         super.onResume();
         if (wxsdkInstance != null) {
             wxsdkInstance.onActivityResume();
         }
     }

     @Override
     protected void onPause() {
         super.onPause();
         if (wxsdkInstance != null) {
             wxsdkInstance.onActivityPause();
         }
     }

     @Override
     protected void onStop() {
         super.onStop();
         if (wxsdkInstance != null) {
             wxsdkInstance.onActivityStop();
         }
     }

     @Override
     protected void onDestroy() {
         super.onDestroy();
         if (wxsdkInstance != null) {
             wxsdkInstance.onActivityDestroy();
         }
     }

     @Override
     public void onViewCreated(WXSDKInstance instance, View view) {
         /**
          * 填充视图
          */
         setContentView(view);
     }

     @Override
     public void onRenderSuccess(WXSDKInstance instance, int width, int height) {

     }

     @Override
     public void onRefreshSuccess(WXSDKInstance instance, int width, int height) {

     }

     @Override
     public void onException(WXSDKInstance instance, String errCode, String msg) {
         Log.d("welog", "onException: "+errCode+"//"+msg);
     }
 }

此时，就可以进行Run app 了 当然运行结果是hello world，欢迎讨论指正。

本文地址：https://blog.csdn.net/Naide_S/article/details/107933406