快速开始指南
本指南会帮助你创建一个Tabris.js app的骨架,并在移动设备上测试该app。
如果你只想在你的移动设备上测试一段代码,但又不想在你的电脑上创建app, 可以先看看Tabris.js Playground。
设置移动设备
你只需要一台Android、iOS 或 Windows设备,然后连接到你电脑所在的局域网。 安装Tabris.js 2 开发者 App。 打开app,然后登陆你的GitHub账户(可选)。
配置你的电脑
需要在你的电脑上安装下面的软件:
- Node.js (安装指南)。 node版本 >= 6.0 (命令行执行
node -v
来查看你的node版本)。 - Tabris CLI (命令行执行
npm install -g tabris-cli
). - 一个文本编辑器或自己选一个JavaScript IDE。
创建你的第一个app
为你的项目创建一个空的文件夹,在该文件夹中打开命令行,然后执行tabris init
。 Tabris CLI 会问你几个问题,包括项目名、版本,以及创建一个JavaScript App 还是一个 TypeScript App。
TypeScript 项目更复杂,但也提供了变量类型安全检查,更好的工具链以及用JSX申明UI的能力。推荐来自Java 或 C#的有经验的开发者使用。
为你的第一个app选择 JavaScript App。 Tabris CLI会创建一个简单的示例项目,然后安装依赖。下面是项目中最重要的文件:
package.json
: 这是你项目的中心清单文件,包括app的名字、版本、依赖,并在main
字段中指明了app的入口模块。详情参考npm doc on package.json。src/app.js
: 这是app的入口JS文件。 你可以随意修改它的名字和位置,但必须和package.json
中的main
字段一致。cordova/config.xml
: 这是Cordova的配置文件。只有你打包时才需要这个文件(参考 build documentation)。
当然,你也可以手动配置你的项目。但你至少需要一个package.json
文件来指明tabris的依赖和入口JavaScript文件。如果你手动配置你的项目,你必须在项目目录中运行npm install
来安装tabris模块。
运行app
在项目所在文件夹的命令行中,执行 tabris serve
。这会在可用端口开启一个服务器,然后打印出它的URL,比如 http://<your-ip-address>:8080/
。 在你测试app时,保持该服务器一直运行。
在开发者App中,进入URL栏目,输入命令行中输出的URL,然后点击 Connect。 开发者App就会下载源码,并在你的移动设备上执行。
从屏幕右侧边缘滑动,打开开发控制台,在控制台中重启脚本或者回到开发者app。
现在你可以开始开发了。但你可能需要查看剩下的文档以及Tabris.js代码片段。
发布你的app
对于提交到 App / Play store,你需要打包、贴牌、构建你的app,也可是使用免费的在线构建服务(在 tabrisjs.com中)或者使用本地构建。这些内容在Build your app中说明。
反馈
帮助我们提升Tabris.js!欢迎随时反馈。如果你觉得tabris.js有趣,可以随时邀请你的朋友来使用。