跳到主要内容

快速开始

需要保证已安装 Node.js，并确保 Node 版本是 14 或以上。详见 开发环境。

创建应用​

在终端执行以下命令：

$ npm create ice ice-app

然后按照提示操作即可！

或者你通过附加的命令行选项指定使用的模板：

$ npm create ice ice-app --template @ice/lite-scaffold

看到如下信息说明项目创建成功：

✔ download npm tarball successfully.
info clean package.json...
Initialize project successfully.
Starts the development server.

    cd ice-app
    npm install
    npm start

本地调试​

首先需要安装项目依赖：

# 进入项目目录
$ cd ice-app
# 安装依赖
$ npm install

安装依赖完成以后，执行以下命令以启动调试：

# 启动调试
$ npm start

此时会自动打开浏览器窗口并访问 http://localhost:3000，这时会看到默认页面。

img

部署发布​

执行以下命令以构建生产环境产物：

# 构建
$ npm build

产物默认生成到 build 目录下：

./build
├── css
|  └── index.css
├── index.html
└── js
   ├── framework.js
   ├── index.js
   └── main.js

这时你可以把 build 目录部署到服务器上。

小程序应用​

通过小程序专用的模板创建项目并安装依赖：

$ npm create ice ice-app --template @ice/miniapp-scaffold
$ cd ice-app
$ npm install

可以看到项目的 package.json 中已经配置好命令：

package.json
  "scripts": {
    "start": "ice start",
    "start:wechat": "ice start --target wechat-miniprogram",
    "start:ali": "ice start --target ali-miniapp",
    "build": "ice build",
    "build:wechat": "ice build --target wechat-miniprogram",
    "build:ali": "ice start --target ali-miniapp"
  }

小程序调试​

当需要开发调试小程序时，执行对应的命令即可。例如，需要开发调试微信小程序时，执行

$ npm run start:wechat

编译完成后，命令行会给出相应提示，提醒开发者使用对应的小程序开发者工具打开编译产物目录进行调试预览：

Use wechat-miniprogram developer tools to open the following folder:
~/miniapp-project/build

编译完成后，命令行会给出相应提示，提醒开发者使用对应的小程序开发者工具打开编译产物目录进行调试预览：

Use wechat-miniprogram developer tools to open the following folder:
~/miniapp-project/build

小程序部署发布​

仍以微信小程序为例，执行以下命令以构建微信小程序生产环境产物：

$ npm run build:wechat

产物同样默认生成到 build 目录下。这时你可以使用对应的小程序开发者工具打开 build 目录并将其上传发布。