Skip to content

Latest commit

 

History

History
117 lines (89 loc) · 4.7 KB

README.md

File metadata and controls

117 lines (89 loc) · 4.7 KB

MEngine

项目定位:使用Web技术写Native应用,更接近原生体验,简单容易上手,能快速开发小型应用,典型的Hybrid应用框架。

为更接近Native应用体验,为此做了一些新的尝试(对比PhoneGap),突出在M(Multi) Engine 多引擎上,通过业务逻辑线程分离与多页面同时加载,加快WebView的渲染,让应用感觉更接近Native体验。

先给个简单总结,多引擎加快页面渲染的技术特点(所谓多引擎指多线程与多WebView)

  • UI与业务线程分离
  • 多WebView且同时加载

ps:目前仅支持Android

1 Hello World

上手只用三分钟

Step 1

创建文件夹,名称自定义(推荐以bundle开头),如:bundleHelloWorld

每一个独立的页面属于一个bundle

在bundleHelloWorld中创建index.html文件,并写自己的HTML代码

说明:每一个bundle文件夹包含index.html(当前bundle显示的页面),与app.js(在异步线程处理业务逻辑的js代码,不需要在index.html中声明,此文件可以不写)

Step 2

创建res文件夹,并放入一张logo图片,如icon.png

Step 3

创建 config.json 文件(复制内容时请先删除注释)

{
  // 页面配置
  "pageConfig":{
    // 配置启动页面
    "splash":{
      "splashIcon":"icon.png",
      "splashBgColor":"#f5f5f5"
    },
    // 配置导航页面(首屏展示的页面)
    "nav":[
      {
        "bundleName":"bundleHelloWorld",
        "navIcon":"icon.png",
        "navName":"首页"
      }
    ]
  },
   // 全局配置(目前只支持标题栏背景颜色与刷新按钮颜色配置)
  "globalConfig":{
    "titleColor": "#000000",
    "refreshColor": "#000000"
  },
    // 页面bundle的配置,有多少个页面就有多少个bundle
  "bundleConfig":[
    {
        // 页面bundle的名称
      "bundleName":"bundleHelloWorld",
        // bundle所在目录名称(必须在assets目录下)
      "path":"bundleHelloWorld",
      "lazyInit":"false",
      "enableRefresh":"false"
    }
  ]
}

Step 4

现在的目录结构如下

─┬config.json
 ├res
 │ └icon.png
 └bundleHelloWorld
   └index.html

复制所有文件到到项目的app/src/main/assets目录下(先备份assets目录下文件,删除后覆盖在此目录下)

这个项目直接使用Android Studio打开,最后编译运行OK。(这个作者比较懒,还没开发出自动打包工具)

项目提供了一个简单的HelloWorld可以直接运行,文件在DemoHelloWorld中,参考README.md里的说明运行。

2 项目介绍

项目定位:更接近原生体验,简单容易上手,能快速开发小型应用。

项目特点

  • Hybrid应用
  • 每个bundle都是独立页面,拒绝使用单页面应用(现在的手机内存相对较大,可以不再局限单页应用)
  • 每个bundle基本包含两个文件:index.html负责页面渲染(必选),app.js负责业务逻辑(可选)。
  • index.html只负责Web页面的渲染与消息传递,并不负责业务逻辑处理,其工作在UI线程(index.html里js的运行会阻塞UI渲染)
  • app.js只处理业务逻辑,不能直接进行UI交互,其Runtime不包含document等页面渲染使用的类(app.js运行在工作线程,不会阻塞UI线程渲染)
  • 通过将渲染与业务逻辑线程的分离,尽可能的提高渲染效率
  • 所有WebView默认在应用启动时创建,打开新页面时不用等待页面加载,加快页面打开速度。如果为内存考虑,可以设置延迟加载(lazyInit),如果设置延迟加载则会在打开时再加载页面,一旦页面加载完成则不会释放
  • 可以使用Native自定义的一些UI控件,协助WebView的操作,比如下拉刷新、首页导航、标题栏与返回导航等
  • 页面返回(关闭页面)后WebView并不会被销毁,再次打开时会遗留有上次的数据,所以需要在finish(页面关闭回调)中做些清理操作,这样做的目的是为了减少WebView的重复创建开销

ps:本项目目前还处于初级阶段,以后还会引入更多的特性,使其更接近Native应用。

项目框架结构如下:

3 详细文档

可以直接安装DemoApk里的包,DemoApk的样例直接使用此框架实现,样例中有详细的使用文档,每个页面都是一个特性的样例,可以直接参考使用。

4 开源地址

欢迎大家关注此开源项目,以后还会有更多的新特性加入到此项目。

GitHub https://github.com/hexleo/MEngine

开源中国 https://git.oschina.net/hexleowang/MEngine