Зачем Fastlane на выделенном Mac?
Fastlane, стандартный инструмент автоматизации для разработки iOS и Android. Он обрабатывает всё, от подписи кода до деплоя в TestFlight. Запуск Fastlane на выделенном Mac Mini M4 даёт вам:
Сертификаты подписи кода сохраняются между запусками. Не нужно импортировать/экспортировать при каждой сборке.
DerivedData сохраняется, поэтому fastlane build занимает 2–4 минуты вместо 15+.
Запускайте fastlane snapshot с реальными симуляторами для всех размеров устройств.
Стабильный выделенный Mac-сервер означает меньше нестабильных деплоев и проблем с подписью кода.
Установка Fastlane
Подключитесь по SSH к вашему выделенному серверу сборки Mac mini M4 и установите Fastlane. Для CI мы рекомендуем Bundler: Gemfile фиксирует версию Fastlane, и каждый запуск использует одну и ту же, а Homebrew подходит для локальной работы. Не используйте системный Ruby macOS: текущие версии Fastlane требуют Ruby 3.1 или новее.
Вариант A: Bundler и Gemfile (рекомендуется для CI)
# Ruby 3.1 or later (current Fastlane releases need it; the macOS system Ruby is older)
brew install ruby
echo 'export PATH="/opt/homebrew/opt/ruby/bin:$PATH"' >> ~/.zprofile
export PATH="/opt/homebrew/opt/ruby/bin:$PATH"
# In your project, a Gemfile that pins Fastlane
cd /path/to/your/ios-project
cat > Gemfile <<'EOF'
source "https://rubygems.org"
gem "fastlane", "~> 2.240"
gem "cocoapods" # if using CocoaPods
EOF
bundle install
# Commit Gemfile and Gemfile.lock, then always run Fastlane through Bundler
bundle exec fastlane --version
Вариант B: Установка через Homebrew (для локальной работы)
# Put the preinstalled Homebrew on your PATH (once per account)
echo 'eval "$(/opt/homebrew/bin/brew shellenv)"' >> ~/.zprofile
eval "$(/opt/homebrew/bin/brew shellenv)"
# Install Fastlane with Homebrew
brew install fastlane
# Verify installation
fastlane --version
Инициализация Fastlane в проекте
# Navigate to your project directory
cd /path/to/your/ios-project
# Initialize Fastlane (with the Homebrew install, run: fastlane init)
bundle exec fastlane init
# Choose option 4: "Manual setup"
# This creates the fastlane/ directory with Appfile and Fastfile
Настройка Match для подписи кода
Fastlane Match хранит сертификаты подписи кода и профили обеспечения в приватном Git-репозитории или облачном хранилище. Это гарантирует, что все машины (и члены команды) используют одну и ту же подпись.
Инициализация Match
# Initialize match (choose "git" for storage)
fastlane match init
# This creates fastlane/Matchfile
Настройка Matchfile
# fastlane/Matchfile
git_url("https://github.com/your-org/ios-certificates.git")
storage_mode("git")
type("appstore") # default type, can be overridden per lane
app_identifier(["com.yourcompany.myapp"])
username("your-apple-id@example.com")
# For CI environments, use App Store Connect API key instead of username/password
# api_key_path("fastlane/AuthKey.json")
Генерация сертификатов
# Generate development certificates and profiles
fastlane match development
# Generate App Store distribution certificates and profiles
fastlane match appstore
# For ad-hoc distribution
fastlane match adhoc
# On CI, use readonly mode to avoid accidentally creating new certs
fastlane match appstore --readonly
Создание Fastfile (лейны сборки, тестирования, деплоя)
Вот полный Fastfile с лейнами для сборки, тестирования и деплоя вашего iOS-приложения:
# fastlane/Fastfile
default_platform(:ios)
platform :ios do
# ---- SHARED ----
before_all do
setup_ci if ENV['CI'] # Configures keychain for CI environments
end
# ---- BUILD ----
desc "Build the app for testing"
lane :build do
match(type: "development", readonly: true)
build_app(
workspace: "MyApp.xcworkspace",
scheme: "MyApp",
configuration: "Debug",
destination: "generic/platform=iOS Simulator",
# Outside the checkout, so it survives the next git clean
derived_data_path: File.expand_path("~/DerivedData/MyApp"),
skip_archive: true,
skip_codesigning: true
)
end
# ---- TEST ----
desc "Run all unit and UI tests"
lane :test do
run_tests(
workspace: "MyApp.xcworkspace",
scheme: "MyApp",
devices: ["iPhone 17"], # any device from: xcrun simctl list devices available
derived_data_path: File.expand_path("~/DerivedData/MyApp"),
result_bundle: true,
output_directory: "fastlane/test_results",
parallel_testing: true,
concurrent_workers: 4
)
end
# ---- BETA ----
desc "Build and push a new beta to TestFlight"
lane :beta do
# Ensure we are on a clean git state
ensure_git_status_clean
# Fetch App Store certificates
match(type: "appstore", readonly: true)
# Increment build number (the API key avoids an Apple ID login and 2FA)
increment_build_number(
build_number: latest_testflight_build_number(
api_key_path: "fastlane/AuthKey.json"
) + 1
)
# Build the app
build_app(
workspace: "MyApp.xcworkspace",
scheme: "MyApp",
export_method: "app-store",
derived_data_path: File.expand_path("~/DerivedData/MyApp"),
output_directory: "fastlane/builds"
)
# Upload to TestFlight
upload_to_testflight(
skip_waiting_for_build_processing: true,
api_key_path: "fastlane/AuthKey.json"
)
# Commit the version bump
commit_version_bump(
message: "chore: bump build number [skip ci]",
force: true
)
# Tag the release
add_git_tag(
tag: "beta/#{lane_context[SharedValues::BUILD_NUMBER]}"
)
push_to_git_remote
end
# ---- RELEASE ----
desc "Build and submit to App Store Review"
lane :release do
match(type: "appstore", readonly: true)
# Increment version number (patch)
increment_version_number(bump_type: "patch")
increment_build_number(
build_number: latest_testflight_build_number(
api_key_path: "fastlane/AuthKey.json"
) + 1
)
build_app(
workspace: "MyApp.xcworkspace",
scheme: "MyApp",
export_method: "app-store",
derived_data_path: File.expand_path("~/DerivedData/MyApp")
)
upload_to_app_store(
submit_for_review: true,
automatic_release: false,
api_key_path: "fastlane/AuthKey.json",
precheck_include_in_app_purchases: false,
force: true # skip the HTML preview prompt, which fails in non-interactive CI
)
commit_version_bump(message: "chore: release #{lane_context[SharedValues::VERSION_NUMBER]}")
add_git_tag
push_to_git_remote
end
# ---- ERROR HANDLING ----
error do |lane, exception|
# Send notification on failure (Slack, email, etc.)
# slack(
# message: "Lane #{lane} failed: #{exception.message}",
# success: false
# )
end
end
Настройка автоматических скриншотов
Fastlane Snapshot автоматически делает скриншоты для App Store на нескольких устройствах и языках. На выделенном Mac это работает надёжно без конкуренции за ресурсы.
# Initialize snapshot
fastlane snapshot init
# This creates:
# - fastlane/Snapfile
# - fastlane/SnapshotHelper.swift (add to UI test target)
Настройка Snapfile
# fastlane/Snapfile
# Simulator names from: xcrun simctl list devices available
devices([
"iPhone 18 Pro Max",
"iPhone 17",
"iPad Pro 13-inch (M5)"
])
languages([
"en-US",
"fr-FR",
"de-DE",
"ja"
])
scheme("MyAppUITests")
output_directory("./fastlane/screenshots")
clear_previous_screenshots(true)
# Speed up by running in parallel
concurrent_simulators(true)
Добавление Snapshot в UI-тесты
// In your XCUITest file:
import XCTest
class ScreenshotTests: XCTestCase {
override func setUp() {
continueAfterFailure = false
let app = XCUIApplication()
setupSnapshot(app)
app.launch()
}
func testHomeScreen() {
snapshot("01_HomeScreen")
}
func testDetailScreen() {
let app = XCUIApplication()
app.cells.firstMatch.tap()
snapshot("02_DetailScreen")
}
func testSettings() {
let app = XCUIApplication()
app.tabBars.buttons["Settings"].tap()
snapshot("03_Settings")
}
}
Добавление лейна для скриншотов
# Add to your Fastfile:
desc "Capture App Store screenshots"
lane :screenshots do
capture_screenshots
frame_screenshots(white: true) # Add device frames
upload_to_app_store(
skip_binary_upload: true,
skip_metadata: true,
api_key_path: "fastlane/AuthKey.json",
force: true # skip the HTML preview prompt when run in CI
)
end
Деплой в TestFlight
Для CI-окружений используйте API-ключ App Store Connect вместо учётных данных Apple ID. Это позволяет избежать запросов 2FA на безголовых серверах.
Создание API-ключа
- Перейдите в App Store Connect > Users and Access > Integrations > App Store Connect API
- Нажмите кнопку + для генерации нового API-ключа
- Выберите роль App Manager
- Скачайте файл
.p8 - Запишите Key ID и Issuer ID
Создание JSON API-ключа
# fastlane/AuthKey.json
{
"key_id": "YOUR_KEY_ID",
"issuer_id": "YOUR_ISSUER_ID",
"key": "-----BEGIN PRIVATE KEY-----\nYOUR_P8_KEY_CONTENT\n-----END PRIVATE KEY-----",
"in_house": false
}
# IMPORTANT: Add this to .gitignore!
echo "fastlane/AuthKey.json" >> .gitignore
Запуск деплоя
# Deploy to TestFlight
fastlane beta
# Or run the full release pipeline
fastlane release
Интеграция с CI/CD
Fastlane интегрируется с любой CI/CD платформой. Вот пример GitHub Actions с использованием self-hosted раннера Mac Mini M4:
# .github/workflows/deploy.yml
name: Deploy to TestFlight
on:
push:
branches: [ main ]
jobs:
deploy:
runs-on: [self-hosted, macOS, ARM64, M4]
# push_to_git_remote needs write access: the token is read-only by default
permissions:
contents: write
env:
# Xcode for this job, without sudo
# (preinstalled Xcode; for another version, use the path from `xcodes installed`)
DEVELOPER_DIR: /Applications/Xcode.app/Contents/Developer
MATCH_PASSWORD: ${{ secrets.MATCH_PASSWORD }}
# base64 of "github_username:personal_access_token", for example:
# echo -n your_github_username:your_personal_access_token | base64
MATCH_GIT_BASIC_AUTHORIZATION: ${{ secrets.MATCH_GIT_BASIC_AUTHORIZATION }}
steps:
- name: Checkout
uses: actions/checkout@v7
- name: Use the Homebrew Ruby (3.1 or later)
run: echo "/opt/homebrew/opt/ruby/bin" >> "$GITHUB_PATH"
- name: Set up App Store Connect API Key
run: |
mkdir -p fastlane
echo '${{ secrets.APP_STORE_CONNECT_API_KEY }}' > fastlane/AuthKey.json
- name: Install dependencies
run: |
bundle install
pod install # if using CocoaPods
- name: Deploy to TestFlight
run: bundle exec fastlane beta
- name: Clean up API key
if: always()
run: rm -f fastlane/AuthKey.json
Лучшие практики
Добавьте Gemfile с фиксированной версией Fastlane. Используйте bundle exec fastlane для обеспечения согласованности версий во всех окружениях.
API-ключи избавляют от запросов 2FA и более безопасны для CI-окружений.
match --readonly в CI
Предотвращает случайное создание новых сертификатов. Генерируйте сертификаты вручную только по необходимости.
setup_ci в CI-окружениях
Это создаёт временный Keychain, чтобы не засорять системный Keychain и предотвращает диалоги разрешений.
На выделенном Mac укажите derived_data_path для повторного использования артефактов сборки между запусками.