Tích hợp Ci trong lập trình iOS với TeamCity

Bài đăng này đã không được cập nhật trong 3 năm

1. Giới thiệu.

Với nhiều người, khái niệm Continuous Integration (CI) là một cái gì đó nghe rất cao siêu và hoành tráng. Tuy nhiên hiểu một cách đơn giản nó là việc tích hợp code của mọi người và tự động build, nó giúp đảm bảo code có thể chạy hay không và đảm bảo chạy đc các unit test.

Mô hình của CI như sau:

2. Các định nghĩa cơ bản.

Version Control System (VCS): hệ thống được sử dụng để theo dõi các thay đổi và kiểm soát phiên bản. Ví dụ như: Git, BitBucket.
CI Server: Máy chủ giám sát VCS và thông báo cái gì và khi nào sẽ chạy.
Build Agent: Máy để build và test theo lệnh của CI server
Package manager:
Dependency resolution: là công nghệ cung cấp cách cài đặt, quản lý và cập nhật các thư viện của bên thứ ba theo chương trình
GUID/UUID: là một số 128 bit được đảm bảo là duy nhất.

3. Các điều bạn cần có?

Một server chạy CI, có thể chạy trên nhiều hệ điều hành khác nhau hoặc có thể bạn chạy localhost.
Một build agent, cần chạy MacOS. Nên có hiệu năng cao và cần set chế độ NoSleep cũng có thể là máy chủ CI
Xcode cần phải được cài đặt trên build agent đó.
Trong bài viết này mình sẽ sử dụng TeamCity, bạn có thể xem nhiều công cụ hỗ trợ chạy CI khác.

4. Các bước cài đặt

Cài đặt TeamCity:

Trước hết bạn cần cài đặt JDK 1.8
Tiếp đến hãy tải TeamCity từ trang chủ.
Mở Terminal và cd tới thư mục bin trong thư mục TeamCity vừa tải về
Để chạy TeamCity server chúng ta sử dụng lệnh ./runAll.sh start và để dừng server ./runAll.sh stop kill
Bạn hãy run server ci và truy cập vào localhost:8111 để tiếp tục việc cài đặt

Hãy chờ giây lát để quá trình init hoàn thành. Sau đó chúng ta sẽ khởi tạo account

Trên là các bước cơ bản ban đầu. Tiếp theo chúng ta cần khởi tạo 1 project có Unit Test và đẩy nó lên 1 repo Github ( bạn có thể sử dụng các loại lưu trữ source code khác).

Khởi tạo Xcode project.

Tạo 1 repo trên Github để quản lý source code demo.
Tạo 1 project demo có cách unit test và đẩy lên Github.

Config các dependency

Gem

Trong project chúng ta cần cài đặt Gem. công cũ để hỗ trợ cài đặt các dependency cần thiết cho quá trình chạy. Để cài đặt Gem chúng ta sử dụng lệnh trên Terminal như sau: Sudo gem install bundle.
Tiến hành cài đặt GemFile để định nghĩa các dependency: Bundle init và chạy bundle install để install chúng
Config Gemfile:
Trong Gemfile chúng ta có định nghĩa Fastlane, nó hỗ trợ việc chạy các lệnh js để tiến hành build & test

Fastlane

Để khởi tạo fastlane chúng ta chạy lệnh fastlane init sẽ có 4 lựa chọn cách cài đặt. ở đây mình sẽ dùng cách manual
Sau khi chạy xong sẽ có 1 thư mục fastlane đc sinh ra trong project của bạn với 2 file như sau :
Config FastFile: trong đây bạn sẽ viết các câu lệnh js để thực hiện các bước mà chúng ta sẽ chạy
Trong file này chúng ta sẽ định nghĩa chạy các pod và có hàm để build và test. Bạn có thể tuỳ chỉnh theo mong muốn.

Sau khi đã chuẩn bị đầy đủ về project và các dependency thì hãy đẩy tất cả lên github và tiếp tục config với TeamCity.

Config TeamCity.

Khởi tạo project, điền các thông tin tương ứng.
Sau khi khởi tạo xong project chúng ta sẽ tiếp tục config các bước build step. Lựa chọn build step dạng Command Line. Chúng ta sẽ có 2 bước cơ bản: Cài đặt các dependency và build & test

Config VCS: Chọn mục Version Control Settings ở bên trái và chọn vào VSC mới khởi tạo.
Hãy thêm đoạn mã +:refs/pull/*/head như trong hình để trigger khi bạn đẩy pull request nhé
Config thêm các feature: các công cụ hỗ trợ thêm, ở đây mình sử dụng 3 công cụ
- Commit status publisher: hiển thị trạng thái của PR
- XML report processing: Lưu log lại quá trình chạy
- Build files clean: Xoá các file đã tạo chuẩn bị cho 1 lần chạy mới.

Config Agents:

Khi bạn chạy local thì teamcity mặc định sẽ coi máy bạn là 1 default agent. Bạn có thể trực tiếp chạy trên đó hoặc có thể add thêm các máy khác làm agent trong mục Agent push