安装Surge命令行工具
确保你已经安装了Surge工具,如果你使用Mac,可以通过以下命令安装Homebrew(推荐的包管理器):
/bin/bash -c "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/HEAD/install.sh)"
安装Surge:
brew install surge
初始化Surge项目
在你的iOS项目目录中运行以下命令:
surge init
这会生成一个surge.json文件,文件内容如下:
{
"name": "your-project-name",
"description": "your project description",
"keywords": ["keyword1", "keyword2"],
"app": "path/to/your/Xcode/project.xcodeproj"
}
将path/to/your/Xcode/project.xcodeproj替换为你的实际项目路径。
配置Xcode项目
在Xcode中:
- 选择项目 → 新建 → 项目(或选择现有的项目)。
- 设置 → 项目编辑器 → 选项 → iOS设备 → 选择需要部署的设备(如iPhone 5s)。
- 设置 → 项目编辑器 → 选项 → 选项设置 → 确保允许Xcode直接提交Archive。
编写surge.json
根据需要调整surge.json,特别是app字段:
{
"name": "your-project-name",
"description": "your project description",
"keywords": ["keyword1", "keyword2"],
"app": "path/to/your/Xcode/project.xcodeproj",
"build": {
"name": "Debug",
"device": "iPhone 5s",
"configuration": "Debug"
}
}
部署到Surge
在项目根目录下运行:
surge build
这会将Xcode Archive上传到Surge服务器,并自动创建一个公共链接。
发布到生产环境
当你准备好发布到生产环境时,重复步骤5,然后将surge.json中的"prod": true设为true以自动删除旧版本。
使用命令查看发布列表
surge list
其他配置
- 多环境部署:在
surge.json中添加"env": "development"或"prod": true。 - 自动化构建:使用Jenkins或其他CI工具自动构建和部署。
常见问题
- 权限问题:确保Xcode和Surge命令有权限写入目标目录。
- Xcode配置错误:检查Xcode的选项设置是否正确,特别是设备和选项设置。
通过以上步骤,你可以成功配置并部署iOS项目到Surge。









