Unity3D项目在iOS平台持续集成

你一身傲骨怎能输

已于 2024-10-27 10:44:48 修改

阅读量655

点赞数 18

分类专栏：自动构建工具文章标签： ios ci/cd

于 2024-10-27 10:43:06 首次发布

本文链接：https://blog.csdn.net/qq_33060405/article/details/143265145

版权

自动构建工具专栏收录该内容

20 篇文章 0 订阅

订阅专栏

持续集成

Unity3D项目在iOS平台的持续集成（Continuous Integration, CI）是一种软件开发实践，旨在通过频繁地将代码集成到主分支来提高软件质量和开发速度。这个过程通常涉及自动化的构建、测试和验证，确保每次代码提交后，整个应用仍然是可工作的，并且新的更改没有引入任何破坏性的错误。

持续集成的关键组成部分

对于使用Unity3D开发iOS应用的项目，持续集成通常包括以下几个关键步骤：

自动化构建：
- 使用Unity编辑器脚本自动化构建过程，这包括设置构建配置、指定目标平台为iOS、选择需要构建的场景等。
- 构建过程生成的是Xcode项目，这是iOS应用开发的标准形式。
自动化测试：
- 在Unity中进行单元测试和集成测试，确保游戏逻辑和功能的正确性。
- 对生成的Xcode项目进行额外的测试，如使用XCTest进行iOS原生代码的测试。
代码质量检查：
- 集成代码静态分析工具，如SonarQube，以检查代码质量和潜在的安全问题。
自动化部署：
- 使用工具如Fastlane自动化iOS应用的打包、签名和部署过程，可以将应用直接上传到TestFlight或App Store Connect。

持续集成的好处

快速发现和修复错误：
- 通过在代码提交后立即运行构建和测试，可以快速发现并修复引入的错误，减少问题积累。
提高开发效率：
- 自动化的流程减少了手动操作的需要，使开发团队可以更专注于功能开发而非重复的构建和部署任务。
增强代码质量：
- 持续的测试和代码审查帮助提高代码的整体质量和可维护性。
简化协作过程：
- 当团队成员频繁地集成他们的工作时，减少了代码合并冲突的可能性，使团队协作更加顺畅。
提高项目可见性和反馈速度：
- 持续集成提供了项目的即时构建状态，帮助团队及时了解项目进展和问题。

实施持续集成的挑战

环境配置：iOS构建需要macOS环境，这可能需要特定的CI工具支持或云服务。
学习曲线：团队可能需要时间来适应新的工具和流程。
初期设置复杂：正确配置所有的自动化步骤可能初期会比较复杂和耗时。

总之，Unity3D项目在iOS平台的持续集成是一个强大的实践，可以显著提高开发效率和软件质量，尽管它可能需要一些时间和资源来正确设置和维护。

背景

现在软件行业对于持续集成的使用已经越来越多。使用持续集成能够过频繁的构建所提交代码，有效的减少项目的风险。在bug产生之后，持续集成能让我们尽快发现，这样也比较容易找到bug源头，以下会把重点放在unity3d项目和ios平台的特别之处上。

Unity3D项目在iOS平台持续集成面临哪些问题需要解决

在 Unity3D 项目中实现 iOS 平台的持续集成 (CI) 时，你将面临一系列挑战和问题，需要适当的解决方案来确保流程的顺利进行。以下是一些主要问题及其解决策略：

1. 环境配置

MacOS 机器：iOS 构建必须在 MacOS 系统上进行，因此你需要确保 CI 系统可以访问 MacOS 服务器或虚拟机。
Xcode 和 Unity 安装：确保所有必要的开发工具，特别是 Xcode 和 Unity，都安装在 CI 服务器上，并且版本与你的开发环境保持一致。

2. 依赖管理

外部库和插件：确保所有外部依赖项，如第三方库和 Unity 插件，都能在 CI 环境中正确安装和配置。
CocoaPods：如果你的项目使用 CocoaPods 管理 iOS 依赖，则需要确保 CI 环境配置了正确的 Ruby 环境和 CocoaPods。

3. 自动化构建脚本

Unity 构建脚本：编写自动化脚本来控制 Unity 编辑器从命令行进行项目构建。这通常涉及到编写一个 Unity 编辑器脚本，用于设置构建配置并触发构建过程。
Xcode 项目后处理：自动化处理 Xcode 项目设置，如签名、配置文件等，可以使用如 Fastlane 这样的工具来简化这一过程。

4. 证书和签名

自动管理证书：iOS 应用的构建和部署需要有效的开发者证书和配置文件。使用如 Fastlane 的 match 工具可以自动化证书和签名文件的管理。
安全存储：确保敏感数据（如 API 密钥、证书等）安全地存储和访问，可以使用环境变量或安全的秘密管理系统。

5. 持续集成工具配置

选择合适的 CI 工具：选择支持 MacOS 和 iOS 构建的 CI 工具，如 Jenkins、Travis CI、GitHub Actions 或 CircleCI。
配置构建流水线：配置 CI 工具以自动触发构建、测试和部署流程。这可能包括在代码提交后自动开始构建，构建成功后部署到测试设备等。

6. 自动化测试

单元测试和集成测试：确保你的 CI 流程包括运行自动化测试，这可能包括 Unity 编辑器测试和在模拟器或真实设备上运行的 iOS 应用测试。
性能测试：定期运行性能测试以监控应用的性能表现。

7. 监控和通知

构建状态监控：配置 CI 工具以监控构建状态并在构建失败或成功时发送通知。
日志和报告：确保生成详细的构建日志和测试报告，以便在出现问题时进行调试。

8. 部署和分发

测试版部署：使用 TestFlight 或类似服务自动部署 iOS 应用的测试版本。
生产部署：配置自动化流程以将应用部署到 App Store，可能需要人工审核的步骤。

通过解决这些问题，你可以建立一个高效、可靠的 iOS 持续集成环境，从而加快开发周期，减少人为错误，提高软件质量。

现有版本流程：

版本在真机iphone上测试，看效果时：
1．在mac机上通过svn取得项目，使用mac下的unity编辑器转换格式到ios平台。

2．在unity内进行编译。unity会生成一个新的xcode项目，包含了需要的资源和代码。

3．更改其中obj-c文件添加一些底层功能，此项目需要。

4．将网络代码的c++文件添加到这个xcode项目中。

5．使用xcode编译这个项目，并安装到iphone上。

是不是觉得这个流程非常麻烦重复？？

此过程有以下缺点和问题：

Mac下从svn上得到项目后，用unity打开会自动重新导入美术资源。而切换到ios平台时又需要重新导入一次，资源多了以后速度很慢。

加入c++代码或obj-c代码，需要更改生成的xcode项目。而这个xcode项目每次会被重新生成，也就是每次都要手工修改。

因为以上的问题，导致我们拿到一个ios版本是比较麻烦的。

持续集的好处

持续集成（CI）在 Unity3D 项目的 iOS 平台开发中带来了多方面的好处，这些好处不仅提高了开发效率，还增强了产品的质量和稳定性。以下是一些主要的好处：

1. 提高开发效率

自动化构建和部署：自动化的构建和部署流程减少了重复性工作，使开发团队能够专注于核心开发任务，如功能开发和问题修复。
快速反馈：开发者可以在代码提交后立即获得构建和测试的结果，快速发现并解决问题，减少了问题积累的风险。

2. 增强代码质量

持续的代码测试：自动运行的单元测试和集成测试帮助确保代码更改不会破坏现有功能，提高了代码的健壮性。
早期发现问题：通过在开发初期发现和解决问题，避免了问题在项目后期扩大，减少了修复成本和时间。

3. 更好的团队协作

透明的开发过程：持续集成提供了一个透明的开发过程，团队成员可以看到每次提交的效果，了解项目的当前状态。
减少冲突：频繁的代码集成减少了代码合并时的冲突，因为差异较小，更容易管理。

4. 提高项目可预测性

持续的进度反馈：通过持续集成，项目进度和质量可以实时监控，帮助项目管理者做出更准确的预测和决策。
稳定的发布周期：自动化流程确保了每次构建的一致性，使得产品的发布周期更加稳定和可预测。

5. 减少手动错误

减少人为错误：自动化构建和测试减少了因手动过程中的疏忽或错误而引起的问题。
标准化构建流程：持续集成确保每次构建都按照相同的标准和步骤执行，提高了构建的可靠性。

6. 更快的市场响应

快速迭代：持续集成支持快速迭代开发，使得新功能和改进能够更快地推向市场。
及时的客户反馈：通过快速部署到测试环境，可以更快地获得用户反馈，及时调整产品方向和功能。

结论

对于 Unity3D 项目在 iOS 平台的开发，实施持续集成是提高效率、质量和团队协作的有效策略。它不仅使开发过程更加自动化和标准化，还帮助团队更好地应对快速变化的市场需求，最终推出更成功的产品。

参考上述工作流程，我们解决上面这些问题需要具备的条件：

l 使用一个适合的持续集成软件

l 使用自动脚本控制unity

l 使用自动脚本控制xcode

l 发送报告邮件

持续集成的具体流程

Unity3D项目在iOS平台进行持续集成的具体流程涉及多个步骤，从代码提交到自动化构建、测试、并最终部署。以下是一个详细的流程说明，帮助你理解每个环节如何操作：

1. 代码提交

开发者在本地完成代码的开发和基本测试后，将代码提交到版本控制系统（如Git）。
提交通常包括源代码、资源文件、测试脚本等。

2. 触发持续集成

持续集成系统（如Jenkins, Travis CI, GitHub Actions等）配置为监听版本控制系统的变更。
一旦检测到新的提交，CI系统将自动触发一个新的构建流程。

3. 自动化构建

构建Unity项目：CI系统通过调用Unity命令行接口或使用Unity编辑器脚本自动化构建Unity项目。这包括选择正确的构建目标（iOS），配置场景，设置构建参数等。
生成Xcode项目：Unity构建完成后，会生成一个Xcode项目。

4. 自动化测试

Unity层测试：运行Unity内的测试框架（如Unity Test Framework），执行单元测试和集成测试。
iOS原生测试：使用Xcode或其他工具（如XCTest）运行iOS原生代码的测试。
UI自动化测试：如果配置了UI测试（如使用Appium或XCTest UI），此步骤将自动执行这些测试。

5. 代码质量检查

可选地，集成代码质量检查工具（如SonarQube）来分析代码并生成质量报告。

6. 构建结果处理

如果构建或测试失败，CI系统将通知开发团队（通过邮件、Slack等方式）。
如果构建和测试成功，可以进一步自动化部署流程。

7. 自动化部署

打包和签名：使用工具如Fastlane自动化处理iOS应用的打包和签名过程。
上传到测试平台或App Store：自动将构建好的应用上传到TestFlight或App Store Connect，供内部测试或发布。

8. 反馈和迭代

开发团队根据CI系统提供的反馈进行代码修正或优化。
持续集成系统持续监听新的代码提交，重复上述流程。

工具和服务选择

CI/CD服务：选择支持macOS的CI服务，如Jenkins（自托管），Travis CI，CircleCI，GitHub Actions等。
自动化脚本工具：使用如Fastlane等工具来简化iOS的构建、测试、部署流程。
测试框架：Unity Test Framework, XCTest, Appium等。

通过这样的流程，Unity3D项目在iOS平台的持续集成可以大大提高开发效率，减少人为错误，加快产品迭代速度，并提高最终产品的质量。

具体流程

首先要有一台机器。这台机器装有所需的开发环境，并能连接到svn服务器。
要有一个适合的持续集成软件。
配置好持续集成机器上的邮件系统。
每次构建时，由持续集成软件负责取得svn上的最新版。
在bash脚本中启动unity3d进行资源转换。这里是要点1：Unity本身可以用命令行启动，并指定打开哪个路径。但是，要想进行转换平台的工作，就没有合适的命令行参数可用了。因此需要在unity里写一个editor script来做这件事。在这个unity脚本中可以调用unity提供的命令BuildPipeline.BuildPlayer来完成转换平台，重新导入资源，生成xcode项目的工作。
在bash脚本中复制修改过的obj-c文件到xcode项目目录下，覆盖原文件。
使用apple script向生成的xcode项目中添加c++文件。这里是要点2：xcode没有提供足够的命令行参数对xcode项目进行操作，但是apple script可以做到，而apple script又可以嵌在bash脚本里。
编译生成的xcode项目
然后post build事件中发送邮件给相关人员。

面临的问题

Unity3D项目在iOS平台进行持续集成时，可能会遇到一系列特定的挑战和问题。这些挑战主要源于iOS平台的特殊要求、Unity3D的特性以及持续集成环境的配置复杂性。以下是一些常见的问题：

1. 环境依赖性

macOS限制：iOS应用的构建必须在macOS系统上进行，这限制了可用的持续集成服务选择。虽然有如Jenkins、Travis CI、GitHub Actions等支持macOS的CI服务，但这些服务可能比标准的Linux服务器更昂贵或更难配置。
硬件资源：iOS构建和模拟器测试可能需要较高的硬件资源，这可能导致构建速度慢，特别是在资源受限的CI环境中。

2. 自动化测试的复杂性

Unity测试与iOS测试分离：Unity中的测试主要针对游戏逻辑，而iOS原生层的测试则需要额外的工具和框架（如XCTest）。这种分离可能导致测试流程复杂化。
UI自动化测试：iOS应用的UI自动化测试（如使用Appium或XCTest UI）可能难以设置，并且执行时间较长。

3. 证书和配置管理

自动签名管理：iOS应用需要有效的签名才能安装和运行。自动化管理开发和分发证书、配置文件等可能复杂且容易出错。
安全性问题：持续集成环境中需要安全地处理敏感数据（如API密钥、证书等），防止泄露。

4. 构建和部署的自动化

构建脚本的编写：Unity项目需要特定的脚本来自动化导出Xcode项目，这些脚本需要精确控制构建参数和过程。
部署自动化：自动化将构建好的应用上传到TestFlight或App Store可能涉及复杂的脚本和第三方工具（如Fastlane），这些工具的学习和维护也是一个挑战。

5. 版本兼容性和依赖管理

Unity与Xcode的兼容性：Unity版本更新可能会引入与现有Xcode版本或iOS SDK不兼容的问题。
依赖库的管理：Unity项目可能依赖多个第三方库和插件，这些依赖项需要在CI环境中正确管理和更新。

6. 团队协作和流程问题

流程标准化：确保所有开发人员遵循相同的代码提交和测试标准，以免破坏CI流程。
反馈循环：在持续集成中快速有效地处理反馈和错误修复，需要良好的团队沟通和协作机制。

解决这些问题通常需要投入时间进行适当的配置、选择合适的工具和服务，并可能需要专门的培训来确保团队成员能够有效使用持续集成系统。

Unity3D项目在iOS平台持续集成的代码执行流程

在Unity3D项目的iOS平台持续集成中，代码执行流程涉及多个自动化步骤，从代码的提交到最终的部署。这里，我将详细解释每个步骤中代码是如何执行的，以及涉及的关键脚本和工具。

1. 代码提交

开发者将更改提交到版本控制系统（如Git）。这通常通过命令行或Git客户端完成，例如：
```
git add .
git commit -m "Add new feature"
git push origin master
```

2. 触发持续集成

持续集成系统（例如Jenkins, Travis CI, GitHub Actions）配置了针对版本控制系统的webhooks，当检测到新的代码提交时，自动触发构建流程。

3. 自动化构建

构建Unity项目：

CI系统通过调用Unity命令行工具来自动化构建过程。这通常涉及到编写一个Unity编辑器脚本，该脚本配置构建设置并调用BuildPipeline.BuildPlayer方法来创建iOS目标的构建。

示例Unity编辑器脚本（Build.cs）：

using UnityEditor;
using System.Linq;

class BuildScript {
    static void PerformBuild() {
        string[] defaultScene = { "Assets/Scene1.unity" };
        BuildPipeline.BuildPlayer(defaultScene, "Builds/iOS", BuildTarget.iOS, BuildOptions.None);
    }
}

在CI脚本中调用Unity编辑器脚本：

/Applications/Unity/Hub/Editor/2020.1.0f1/Unity.app/Contents/MacOS/Unity -batchmode -projectPath $(pwd) -executeMethod BuildScript.PerformBuild -quit

4. 自动化测试

Unity测试：

使用Unity Test Runner运行测试。这可以通过命令行与Unity集成，例如：

/Applications/Unity/Hub/Editor/2020.1.0f1/Unity.app/Contents/MacOS/Unity -runTests -projectPath $(pwd) -testResults $(pwd)/test-results.xml -testPlatform iOS -batchmode -quit

iOS原生测试：

使用xcodebuild工具运行XCTest框架的测试：

xcodebuild test -project Unity-iPhone.xcodeproj -scheme Unity-iPhone -destination 'platform=iOS Simulator,name=iPhone 11,OS=13.3'

5. 代码质量检查

可以集成如SonarQube等工具，通过在CI脚本中添加相应的命令来执行代码质量分析。

6. 构建结果处理

CI系统根据构建和测试的结果发送通知（如通过Slack或邮件）。

7. 自动化部署

使用Fastlane自动化iOS的打包和部署流程：
- Fastlane配置文件（Fastfile）定义了打包和上传到TestFlight的步骤。
- 在CI脚本中调用Fastlane：
```
fastlane beta
```

8. 反馈和迭代

开发团队根据CI系统提供的反馈进行代码修正或优化。

这个流程确保了从代码提交到应用部署的每一步都是自动化的，减少了人为错误，加快了开发周期，提高了软件质量。