Tự Động Hóa Build & Test Swift App Với GitHub Actions: Cứu Tinh Của Mọi Lập Trình Viên!

Lê Lân

27/07/2025

Hướng Dẫn Thiết Lập GitHub Actions Cho Quy Trình Build Và Test Ứng Dụng Swift

Mở Đầu

Việc duy trì quá trình build sạch sẽ và các bài test luôn chạy thành công là chìa khóa để phát triển phần mềm hiệu quả và ổn định.

Khi làm việc trên một dự án, tự động hóa việc build và kiểm thử giúp giảm thiểu rủi ro lỗi, tăng tốc độ phát triển và nâng cao chất lượng mã nguồn. Trong bài viết này, bạn sẽ được hướng dẫn chi tiết cách thiết lập một workflow GitHub Actions để TỰ ĐỘNG build và test ứng dụng Swift của bạn mỗi khi có thay đổi được đẩy lên repository.

Chúng ta sẽ đi từ việc chuẩn bị môi trường ban đầu, tạo file workflow theo chuẩn YAML, cho đến kiểm tra kết quả trên GitHub, giúp bạn áp dụng CI/CD (Continuous Integration/Continuous Deployment) một cách hiệu quả nhất cho dự án của mình.

Tại Sao Nên Sử Dụng GitHub Actions?

CI trong phát triển ứng dụng hiện đại

Continuous Integration (CI) là thành phần không thể thiếu trong quy trình phát triển phần mềm hiện nay. Bằng cách tích hợp GitHub Actions vào luồng làm việc, bạn có thể đảm bảo mọi pull request và commit đều được tự động build và test ngay lập tức.

Điều này giúp:

Phát hiện sớm các lỗi phát sinh

Nâng cao độ tin cậy của codebase

Rút ngắn vòng feedback giữa các lần commit

GitHub Actions cung cấp môi trường chạy build trên macOS với các phiên bản Xcode mới nhất, rất phù hợp cho các dự án iOS/Swift.

Bắt Đầu Với GitHub Actions

Chuẩn bị trước khi tạo workflow

Trước khi bắt tay vào, hãy đảm bảo bạn đã có:

Một repository GitHub chứa source code của dự án Swift. Ví dụ: SwiftUIDeepLinking

Kiến thức cơ bản về GitHub Actions và cú pháp YAML

Xcode được cài đặt trên máy tính để kiểm tra project có thể build thành công

Tạo File Workflow Cho GitHub Actions

Cấu trúc folder và file

GitHub Actions định nghĩa workflows bằng các file .yml nằm trong thư mục .github/workflows . Nếu chưa tồn tại, bạn tạo dần theo cấu trúc dưới đây:

.github/
└── workflows/
    └── ci.yml

Định nghĩa trigger cho workflow

Bạn cần xác định khi nào workflow được kích hoạt, ví dụ khi push code lên nhánh main hoặc mở/cập nhật pull request vào main :

name: CI

on:
  push:
    branches: [ "main" ]
  pull_request:
    branches: [ "main" ]

Cấu hình job chạy trên máy macOS

Phần quan trọng nhất là jobs , xác định các tác vụ sẽ được thực thi. Ví dụ, tạo một job tên build chạy trên máy ảo macos-latest :

jobs:
  build:
    name: Build and Test
    runs-on: macos-latest
    steps:

Các Bước Quan Trọng Trong Workflow

Checkout code

Để truy cập source code, đầu tiên bạn cần checkout repository:

- name: Checkout
  uses: actions/checkout@v4

Cài đặt Xcode

Sử dụng action của Maxim Lobanov để setup phiên bản Xcode:

- name: Set up Xcode
  uses: maxim-lobanov/setup-xcode@v1
  with:
    xcode-version: '16.2'

Build dự án Swift

Lệnh xcodebuild được sử dụng để dọn sạch (clean) và build project. Bạn cần chỉnh lại đường dẫn -project và -scheme phù hợp với cấu trúc dự án của mình:

- name: Build
  run: |
    xcodebuild clean build \
      -project Deep_Linking_with_TCA/DeepLinkTCA.xcodeproj \
      -scheme DeepLinkTCA \
      -destination 'platform=iOS Simulator,name=iPhone 16,OS=latest' \
      -skipPackagePluginValidation -skipMacroValidation

Lưu ý: Điều chỉnh -project và -scheme cho đúng với dự án của bạn để tránh lỗi khi build.

Kiểm Tra Và Theo Dõi Workflow

Sau khi commit file ci.yml vào repository, truy cập tab Actions trên GitHub, bạn sẽ thấy workflow chạy tự động sau mỗi lần đẩy code hoặc tạo pull request.

Nếu có lỗi build hoặc test, chúng sẽ được báo cáo chi tiết tại đây, giúp bạn phát hiện và xử lý kịp thời.

Kết Luận: Nâng Cao Quy Trình CI/CD Cho Dự Án Swift

Việc thiết lập CI/CD với GitHub Actions mang lại nhiều lợi ích vượt trội:

Cải thiện chất lượng mã nguồn thông qua các kiểm thử tự động

Giảm thiểu công việc thủ công và sai sót trong quá trình build/test

Rút ngắn thời gian phản hồi của các thay đổi trong dự án

Đảm bảo môi trường build nhất quán và đáng tin cậy trên các runner macOS chính thức

Hãy bắt đầu áp dụng ngay hôm nay để tăng tốc phát triển ứng dụng Swift và nâng cao hiệu suất làm việc nhóm!

Tham Khảo

Maxim Lobanov. setup-xcode GitHub Action

GitHub Docs. Understanding GitHub Actions

Apple Developer. xcodebuild Manual Page

SwiftUIDeepLinking Repository: https://github.com/saeed-rz/SwiftUIDeepLinking