快速开始指南

本指南会帮助你创建一个Tabris.js app的骨架,并在移动设备上测试该app。

:point_right: 如果你只想在你的移动设备上测试一段代码,但又不想在你的电脑上创建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 initTabris CLI 会问你几个问题,包括项目名、版本,以及创建一个JavaScript App 还是一个 TypeScript App

:point_right: 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有趣,可以随时邀请你的朋友来使用。

Tabris.js on TwitterEclipseSource on LinkedInEclipseSource on Google+EclipseSource on Facebook

原文:

https://youjingyu.github.io/Tabris-Documention/?folderName=start&pageName=getting-started.html