161 lines
2.5 KiB
Markdown
161 lines
2.5 KiB
Markdown
# EAS Workflows
|
|
|
|
Automate builds, submissions, and deployments with EAS Workflows. The examples below are deployment-oriented starting points.
|
|
|
|
When you need to write, edit, or validate a workflow YAML file beyond these examples, use the `expo-cicd-workflows` skill.
|
|
|
|
## Web Deployment
|
|
|
|
Deploy web apps on push to main:
|
|
|
|
`.eas/workflows/deploy.yml`
|
|
|
|
```yaml
|
|
name: Deploy
|
|
|
|
on:
|
|
push:
|
|
branches:
|
|
- main
|
|
|
|
# https://docs.expo.dev/eas/workflows/syntax/#deploy
|
|
jobs:
|
|
deploy_web:
|
|
type: deploy
|
|
params:
|
|
prod: true
|
|
```
|
|
|
|
## PR Previews
|
|
|
|
### Web PR Previews
|
|
|
|
```yaml
|
|
name: Web PR Preview
|
|
|
|
on:
|
|
pull_request:
|
|
types: [opened, synchronize]
|
|
|
|
jobs:
|
|
preview:
|
|
type: deploy
|
|
params:
|
|
prod: false
|
|
```
|
|
|
|
### Native PR Previews with EAS Updates
|
|
|
|
Deploy OTA updates for pull requests:
|
|
|
|
```yaml
|
|
name: PR Preview
|
|
|
|
on:
|
|
pull_request:
|
|
types: [opened, synchronize]
|
|
|
|
jobs:
|
|
publish:
|
|
type: update
|
|
params:
|
|
branch: "pr-${{ github.event.pull_request.number }}"
|
|
message: "PR #${{ github.event.pull_request.number }}"
|
|
```
|
|
|
|
## Production Release
|
|
|
|
Complete release workflow for both platforms:
|
|
|
|
```yaml
|
|
name: Release
|
|
|
|
on:
|
|
push:
|
|
tags: ['v*']
|
|
|
|
jobs:
|
|
build-ios:
|
|
type: build
|
|
params:
|
|
platform: ios
|
|
profile: production
|
|
|
|
build-android:
|
|
type: build
|
|
params:
|
|
platform: android
|
|
profile: production
|
|
|
|
submit-ios:
|
|
type: submit
|
|
needs: [build-ios]
|
|
params:
|
|
platform: ios
|
|
profile: production
|
|
|
|
submit-android:
|
|
type: submit
|
|
needs: [build-android]
|
|
params:
|
|
platform: android
|
|
profile: production
|
|
```
|
|
|
|
## Build on Push
|
|
|
|
Trigger builds when pushing to specific branches:
|
|
|
|
```yaml
|
|
name: Build
|
|
|
|
on:
|
|
push:
|
|
branches:
|
|
- main
|
|
- release/*
|
|
|
|
jobs:
|
|
build:
|
|
type: build
|
|
params:
|
|
platform: all
|
|
profile: production
|
|
```
|
|
|
|
## Conditional Jobs
|
|
|
|
Run jobs based on conditions:
|
|
|
|
```yaml
|
|
name: Conditional Release
|
|
|
|
on:
|
|
push:
|
|
branches: [main]
|
|
|
|
jobs:
|
|
check-changes:
|
|
type: run
|
|
params:
|
|
command: |
|
|
if git diff --name-only HEAD~1 | grep -q "^src/"; then
|
|
echo "has_changes=true" >> $GITHUB_OUTPUT
|
|
fi
|
|
|
|
build:
|
|
type: build
|
|
needs: [check-changes]
|
|
if: needs.check-changes.outputs.has_changes == 'true'
|
|
params:
|
|
platform: all
|
|
profile: production
|
|
```
|
|
|
|
## Tips
|
|
|
|
- Use `workflow_dispatch` for manual production releases
|
|
- Combine PR previews with GitHub status checks
|
|
- Use tags for versioned releases
|
|
- Keep sensitive values in EAS Secrets, not workflow files
|