Skip to content

Tencent/RapidView

Repository files navigation

RapidView

RapidView是一套用于开发Android客户端界面、逻辑以及功能的开发组件。布局文件(XML)及逻辑文件(Lua)可以运行时执行,主要用以解决Android客户端界面、逻辑快速更新以及快速开发的诉求。RapidView的XML语法规则与Android原生XML类似,而写逻辑的Lua部分除语言语法规则外,可以直接使用我们提供的Java API以及Android原生API,因此熟悉Android客户端开发的开发者上手成本会非常小。

除了解决动态更新问题外,RapidView希望Android开发者能够以更快的速度开发产品功能需求,因此我们在语法和开发方式上做了一些改变,期望开发者能够实现:小功能极速开发、大功能极速上线。

RapidView希望为开发者带来更小的安装包增量以及更加简单、易于维护和修改的组件库,RapidView的代码组件约180KB(30KB组件+150KB luaj)。

组件特性

  • 运行时加载,布局、逻辑可动态刷新

  • 无需编译,所见即所得,开发效率更高

  • 极小的安装包增量

  • Android开发者低上手成本

  • 与NATIVE开发体验相同

快速上手

我们为开发者提供了一个简单的DEMO,以及一个简易调试工具Rapid Studio。Rapid Studio除了支持简单的XML语法校验,Lua语法高亮以及自动补全外,还可以实现实时调试,这将极大缩短开发者的调试成本。除了这个exe工具外,我们还提供了具有类似功能的Visual Studio Code插件。在VS Code商店中搜索:Rapid Studio可以找到这个插件。

工程引入RapidView

初始化RapidView

将源码添加到工程目录下,在Application类的onCreate方法中添加如下代码进行初始化:

RapidPool.getInstance().initialize(this, null);

如果编译时需要混淆代码,请将*.rapidview.deobfuscated目录保持非混淆状态

加载RapidView

写一张简单的XML布局文件,保存在assets/rapidview目录下。打开RapidConfig.java,在VIEW{}的枚举中分配一个视图名,在Map中与XML关联。

XML布局文件

<relativelayout width="match_parent" height="match_parent" backgroundcolor="ffabcdef">
</relativelayout>

RapidConfig.java

    /**VIEW列表,此处配置仅为防止重名,便于索引。**/
    public enum VIEW{
        native_demo_view, //Demo视图
    }

    /** VIEW和NaitveXML的映射关系,当View不存在服务端下发的XML时,寻找本地XML作为默认布局 **/
    static{
        try{
            msMapViewNaitve.put(RapidConfig.VIEW.native_demo_view.toString(), "demo_view.xml");
        }
        catch (Exception e){
            e.printStackTrace();
        }

在需要加载RapidView的地方插入如下代码,即完成了简单的RapidView加载

        mRapidView = RapidLoader.load(
                RapidConfig.VIEW.native_demo_view.toString(),
                HandlerUtils.getMainHandler(),
                this,
                RelativeLayoutParams.class,
                map,
                null);

        setContentView(mRapidView.getView(), mRapidView.getParser().getParams().getLayoutParams());
        

开发与调试

打开RapidConfig.java,将一个名为DEBUG_MODE的静态boolean成员的值改为true并在本地重新编译并安装到手机。打开Rapid Studio调试小工具,点击文件->打开,选择工程下assets/rapidview目录,打开。

    /**DEBUG_MODE
     * 调试模式是否开启,一般发布时需要关闭。开启调试模式后,可以在rapiddebug目录中配置调试文件。调试文件
     * 实时,并以最高优先级生效。强烈推荐使用RapdiView皮肤引擎专用调试工具RapidStudio Studio调试界面,调
     * 试时需要安装开启调试模式的包。**/
    public final static boolean DEBUG_MODE = true;

工具目录下有一个rapid_config.ini的配置,工程目录中utils目录下有一个FileUtil的文件,这两个地方配置的目录要对应起来,否则调试会失败。

修改XML中的任意可见参数,如backgroundcolor,按ctrl+s保存,观察到log中提示“[100%]xxx”,表明文件被push到手机当中,重新加载当前activity(返回重新进入),查看效果。

Rapid Studio

Visual Studio Code插件

如果打算使用Visual Studio Code,可在插件商店中搜索Rapid Studio,相关介绍链接:

English Document

中文文档

Windows工具

点击下载链接下载Rapid Studio工具包。

许可协议(License)

RapidView使用 MIT 许可协议, 详见License文件。

个人信息保护规则

RapidView 在运行时只获取必要的信息UI加载流程能在不同操作系统版本的设备上正常执行,这些信息不涉及系统敏感权限和用户隐私相关的内容。同时 RapidView 不含上报逻辑,即不会上报获取到的信息。有关 RapidView 获取信息的类型及用途,请查看 RapidView SDK 个人信息保护规则 了解详情。

其它

详细开发指南请参阅开发文档,如果有其它问题,可以扫描下方二维码,加入QQ群咨询

About

RapidView is an android ui and lightapp development framework

Topics

Resources

License

Stars

Watchers

Forks

Releases

No releases published

Packages

No packages published