您最多选择25个主题 主题必须以字母或数字开头,可以包含连字符 (-),并且长度不得超过35个字符
 
 
fng 52b2b69ec7 1 4 年前
libs 1 4 年前
src 1 4 年前
.gitignore 1 4 年前
CHANGELOG.md 1 4 年前
README.md 1 4 年前
build.gradle 1 4 年前
proguard-rules.pro 1 4 年前

README.md

安卓工程

Weex-eros Android框架工程 本部分主要面向android原生开发者,旨在介绍weex-eros-android框架的项目结构和设计思路,方便广大weex开发者进行weex原生拓展开发。

一.功能介绍

weex-eros是在weex原生拓展的基础上,结合我团队具体项目业务场景,总结出来的一套易用性强,侵入性低,快速集成开发的框架,框架中集成内置module,包括路由,本地存储,网络请求,全局参数配置,事件发布订阅,调用摄像头等,基本涵盖大部分业务场景需求,且提供了自定义接口,方便开发者自定义实现。

二.使用框架

目前提供了源码依赖的方式,这是我们比较推荐的方式。如果你使用Android Studio进行开发,你可将项目源码做为Moudle导入项目中,在app的build.gradle中添加如下依赖:

compile project(':wxframework')

关于gradle和maven的依赖方式,我们将以迅雷不及掩耳之势在后续更新放出。

三.项目目录结构

Eros项目的目录结构如下:

项目目录结构
·
|-- BMInitConfig                    initConfig
|-- BMWXApplication                 封装的Application
|-- BMWXEngine                      框架初始化引擎
|-- BMWXEnvironment                 框架上下文
|-- activity                        封装的activity,包括提供weex渲染和一些默认实现页面
     |-- AbstractWeexActivity
|-- adapter                         框架对功能模块具体实现类
     |-- router
     |-- DefaultImageAdapter
     |-- DefaultStorageAdapter
|-- constant                        常量类
|-- event                           处理与js交互的自定义事件
|-- extend                          weex原生的拓展
     |-- adapter
          | -- DefaultWXHttpAdapter 拓展weex原生IWXHttpAdapter
          |-- DefaultWXImageAdapter 拓展weex原生IWXImgLoaderAdapter
    |-- components                  自定义weex组件
    |-- module                      自定义weex module
|-- http                            http实现(默认使用okhttp)
|-- manager                         业务处理管理类
|-- model                           java beans
|-- utils                           utils

四.关键类 总览Eros项目的工程目录,有些类是我们需要特别注意的:

BMWXApplication 此类为Applcation的子类,将你项目的Application继承它,便可以自动完成Eros框架的初始化和内置moudle,component的注册,方便开发者快速集成。

public class BMWXApplication extends Application {

    @Override
    public void onCreate() {
        super.onCreate();
    }

    private void initWeex() {
        BMWXEngine.initialize(this, new BMInitConfig.Builder().isActiceInterceptor(Constant
                .INTERCEPTOR_ACTIVE).build());
    }
}

BMWXEngine 此类是Eros框架的初始化入口,请在你的项目入口调用initialize方法完成初始化。

public class App extends Application {

    @Override
    public void onCreate() {
        super.onCreate();
        BMWXEngine.initialize(this, new BMInitConfig.Builder().isActiceInterceptor(Constant
                .INTERCEPTOR_ACTIVE).build());
    }

}

BMWXEngine内部将完成weex框架的初始化和内置moudle,component的注册以Enviroment.config的参数配置。

    public static void initialize(Application context, BMInitConfig initConfig) {
        initPlatformConfig(context);
        initConing(initConfig);
        engineStart(context);
        registerBMComponentsAndModules(context);
        initHttpClient(context);
        initInterceptor(context, initConfig);
        initDispatchCenter();
    }

此外,为了方便于js端的数据交互,你可以通过BMInitConfig将一些参数放入全局环境中:

  HashMap<String,String> envs=new HashMap<>();
        envs.put("test","test");
        BMWXEngine.initialize(this, new BMInitConfig.Builder().setCustomerEnv(envs).build());

js端可以使用weex.enviroment.config 获取。

AbstractWeexActivity

此类为Application的子类,将你项目的Application继承它,便可以自动完成Eros框架的初始化和内置moudle,component的注册,方便开发者快速集成。

public class BMWXApplication extends Application {

    @Override
    public void onCreate() {
        super.onCreate();
    }

    private void initWeex() {
        BMWXEngine.initialize(this, new BMInitConfig.Builder().isActiceInterceptor(Constant
                .INTERCEPTOR_ACTIVE).build());
    }
}

五.项目地址

目前Eros项目的框架部分已经完全开源,项目地址[https://github.com/aa453509345/WeexErosFramework], 另外WeexErosFramework项目所以来的WeexSDK是我们在Weex原生SDK的基础上,修复了原生SDK的部分bug所维护的SDK,项目地址: [https://github.com/aa453509345/WeexSDK] ,目前Eros项目还在快速开发迭代中,对于功能复杂或自定义程度高度制定的场景支持可能还不够完善,我们会在后续版本中支持完善, 也希望广大weex开发者和开源爱好者提出建议,共同完善Eros。

有任何问题和建议的童鞋,请查看Eros使用手册