1.1.0 • Published 7 years ago

lynx-cli v1.1.0

Weekly downloads
11
License
MIT
Repository
github
Last release
7 years ago

Lynx Command-Line Interface

Lynx是一个使用Javascript来编写Android和iOS原生应用的框架。Lynx选用vue.js作为前端开发框架,当然因为Lynx兼容大部分DOM API,可以接入其他前端框架作为应用的基础开发框架

安装

安装要求: Node.js (>=6.x), npm(3+), Git.

$ npm install -g lynx-cli

初始化工程

$ lynx init <project-name>

例如:

$ lynx init my-project

init命令会从 hxxft/lynx-simple-template下载模版工程, 并且在 ./my-project/目录下生成工程.

编译工程

$ lynx build

Lynx会通过工程目录下面的manfiest.json的配置来编译工程,所有在manifest.json中配置过的页面都会被编译打包至dist目录下面,请确保在执行lynx build之前已经完成npm install的操作

添加平台

在创建完工程之后,开发者可以添加自己想编译打包的平台。

目前暂时只支持android平台,iOS还在开发中,可以直接打开中hxxft/lynx-native的iOS工程进行体验

$ lynx platform add android
$ lynx platform add ios

platform add 命令会在platforms目录下面生成 androidios目录

编译目标平台工程

Lynx可以帮助开发者编译出相应平台的可执行程序,在编译之前请查看相关平台的配置信息(android端需要在环境变量中设置ANDROID_HOMEANDROID_NDK,来配置android的SDK和NDK路径),当然编译过程中也会对环境变量进行检查。在开始编译之前,请先执行lynx build

$ lynx platform build android
$ lynx platform build ios

调试

Lynx支持快速调试页面,同时使用hot reload技术,应用无需重启,即可实时调试页面。在修改页面之后使用debug命令,Lynx将编译页面并重新加载页面,这个过程只需要保持在手机端应用处于运行状态即可

$ lynx debug androd <page-name>
$ lynx debug ios <page-name>

例如:

$ lynx debug android app

配置文件

Lynx的工程配置信息全部存储在manfiest.json中,文件包含了项目名称,包名,页面信息等等

{
  "debug": "false",
  "application": {
    "packageName": "com.test",
    "icon": "icon.png",
    "name": "test",
    "versionCode": "",
    "versionName": "",
    "mainPage": "App.vue",
    "pages": [
      {
        "name": "App.vue"
      }
    ]
  }
}

配置文件中有如下参数

debug 设置应用是否允许被调试,默认不添加情况下是不允许被调试,可以在调试应用的时候加上,发布的时候去掉

packageName 打包应用的包名,为确保应用不会和手机上的应用冲突

icon 应用图标,放置在src路径下面

name 应用的名字,用户能看到的显示出来的名字

versionCode 应用的版本号,用于应用升级,必须使用整数

versionName 显示给用户的版本号

mainPage 主页面,也就是应用启动的第一个页面

pages 应用中所有的页面配置