在Apple Silicon上使用Flutter Action安装Flutter 2.x版本

随着GitHub Actions逐步将macOS最新运行环境迁移到Apple Silicon芯片（如M1/M2），许多使用较旧Flutter版本的项目遇到了兼容性问题。本文将详细介绍如何通过subosito/flutter-action在基于ARM架构的macOS运行环境中正确安装和运行Flutter 2.x版本。

背景与问题

Flutter 3.0之前的版本（包括2.10.x系列）并不原生支持ARM64架构。这些版本原本设计在Intel芯片（x86_64/amd64架构）上运行，在Apple Silicon设备上需要通过Rosetta 2转译层来执行。

当开发者尝试在macOS 14（即最新的macOS运行环境）上使用flutter-action安装Flutter 2.10.5时，会遇到"Unable to determine Flutter version for channel: stable version: 2.10.5 architecture: arm64"的错误提示，这是因为该版本没有提供ARM64架构的二进制包。

解决方案

要解决这个问题，我们需要明确告诉flutter-action下载x64架构的Flutter版本，而不是默认尝试获取ARM64版本。具体配置如下：

- name: Set up Flutter
  uses: subosito/flutter-action@v2
  with:
    channel: stable
    version: 2.10.x
    architecture: x64

关键点在于architecture: x64参数，这会强制Action下载适用于Intel芯片的Flutter版本，然后在Apple Silicon设备上通过Rosetta 2自动转译运行。

技术细节

1. 架构兼容性：Flutter 3.0是首个原生支持Apple Silicon的稳定版本，之前的版本都需要通过Rosetta 2运行。

2. 性能影响：虽然通过Rosetta 2运行会有轻微性能损失，但对于大多数CI/CD场景来说，这种差异可以忽略不计。

3. 版本选择：建议使用2.10.x这样的通配符版本号，让Action自动选择该分支下的最新补丁版本，而不是固定到特定的小版本。

最佳实践

1. 长期维护项目：如果项目需要长期维护，建议考虑升级到Flutter 3.0+版本以获得更好的性能和原生支持。

2. 明确架构指定：即使在Intel芯片上，明确指定架构也是个好习惯，可以避免未来环境变化带来的意外问题。

3. 版本锁定：对于关键项目，建议锁定具体的Flutter版本号，而不是使用通配符，以确保构建一致性。

通过以上方法，开发者可以顺利在最新的Apple Silicon GitHub运行环境中继续使用Flutter 2.x版本进行项目构建和测试。