Công cụ dòng lệnh

Valance trong Terminal và trên CI.

Công cụ dòng lệnh làm việc trên cùng các dự án như ứng dụng: kéo về, so sánh, đẩy lên, xác minh, tải lên bản dựng và gửi xét duyệt. Công cụ đi kèm gói mở khóa Valance.

1. Cài đặt

   Mở trình cài đặt và làm theo các bước. Sau đó kiểm tra xem công cụ đã hoạt động chưa:

   valance version

2. Cung cấp giấy phép

   Trong Valance, chọn Cài đặt → Mua → Xuất giấy phép dòng lệnh và lưu tệp. Sau đó cài đặt giấy phép. Hãy giữ kín: bất kỳ ai có giấy phép này đều dùng được.

   valance license install ~/Downloads/Valance\ License.jws

3. Cung cấp khóa API

   Công cụ không dùng các khóa được lưu trong ứng dụng. Hãy đặt ba biến này, dùng Key ID, Issuer ID (bỏ qua nếu dùng khóa cá nhân) và đường dẫn tới tệp .p8 bạn đã tải về từ App Store Connect.

   export ASC_KEY_ID=ABC123DEFG
   export ASC_ISSUER_ID=00000000-0000-0000-0000-000000000000
   export ASC_PRIVATE_KEY=~/.appstoreconnect/AuthKey_ABC123DEFG.p8

Sử dụng

Mọi lệnh đều làm việc trên một dự án .valance, giống dự án mà ứng dụng tạo ra. Chạy help để xem tất cả.

valance pull MyApp.valance
valance diff MyApp.valance
valance push MyApp.valance
valance help

Trên máy chủ CI

Lưu giấy phép dưới dạng secret và truyền vào VALANCE_LICENSE, có thể là chính giấy phép hoặc đường dẫn tới tệp. verify thoát với lỗi khi App Store Connect không khớp với dự án, nhờ vậy pipeline có thể phát hiện trang App Store đã bị lệch.

VALANCE_LICENSE="$VALANCE_LICENSE" valance verify Listing/MyApp.valance

Gỡ cài đặt

Xóa công cụ và bản ghi của trình cài đặt về công cụ:

sudo rm -rf /usr/local/libexec/valance /usr/local/bin/valance
sudo pkgutil --forget com.ashleycorbion.valance.cli