安装和获取

1 获取

• 下载并安装 surge 库：

  npm install surge

2 端点

• 使用 curl 或 npm CLI 打开 iOS 目前版本的 API：

  curl -v http://api.example.com
  npm install --save

插件与工具

1 插件

• 插件是 Surge 的核心组件，用于定义 API 和功能。
  • surge-interpreter.js：用于定义代码的上下文。
  • surge.hello.js：示例插件。

2 工具

• surge.js：用于定义上下文。
• surge-run.js：用于启动和运行插件。

库

1 surge.js

const surge = require('surge');
const { hello } = require('surge');
export default {
  hello: hello,
};

2 surge-interpreter.js

const surge = require('surge');
const { main } = require('surge-interpreter');
export default {
  main: main,
};

数据

1 插件数据

• 插件可以存储在文件中，app.js：

  const { hello } = require('./app.js');
  // 定义你的插件逻辑
  hello();

2 系统数据

• 系统数据可以存储在 app.js 中：

  const { user, device } = require('./app.js');
  // 数据读取或处理代码
  console.log('用户信息:', user);
  console.log('设备:', device);

工具链

1 系统工具链

• 定义 iOS 应用的工具链：

  const { main } = require('./surge.js');
  const { hello } = require('./surge-interpreter.js');
  main({ hello }) { // hello 会调用插件
    console.log('运行插件');
  }

构建

1 生成

• 使用 npm run build 或 npm run dev：

  npm run build

2 生成测试

• 使用 npm test：

  npm test

测试

1 测试插件

• 测试插件的时候，建议使用 npm test --node：

  npm test --node

2 测试应用

• 测试应用的时候，建议使用 npm test --node --skip-error：

  npm test --node --skip-error

部署

1 本地部署

• 使用 npm run dev 将应用部署到 local。

2 客服部署

• 使用 npm run prod 将应用部署到 server,方便在移动端测试。

跨平台开发

1 共享 API

• 使用 Common API 来实现跨平台开发：

  const { app } = require('./app');
  const { cross-platform } = require('./cross-platform');
  app(cross-platform('yourApp.js'));

2 配置

• 配置文件（如 .dev.config.js）用于管理跨平台开发。

• 使用 Surge 建立 iOS 应用需要理解插件、工具链和数据。
• 通过 npm run build 或 npm run dev 将应用部署。
• 保持代码的可读性和灵活性，使用 Common API 和插件。

希望这个指南能帮助你顺利使用 Surge！如果有任何问题,欢迎随时提问。