go>> betalane>> 返回
项目作者： betalane

项目描述 ：
Betalane - A super easy to use beta distribution tool for iOS
高级语言： JavaScript
项目地址: git://github.com/betalane/betalane.git
创建时间： 2018-08-14T13:27:18Z
项目社区：https://github.com/betalane/betalane
开源协议：
下载


Highly inspired by Fastlane.tools the greatest Automation tool ever for your beta deployments of iOS/Android Builds, but betalane is purely made in Javascript and it’s super easy to use!

Features

  • build - Building your app
  • doa_s3 - Distribute on the Air using AWS S3
  • cli - Execute any cli command

Getting Started

Make sure you have the latest version of the Xcode command line tools installed:

  1. xcode-select --install

Installation

  1. [sudo] npm i betalane -g

Setup

  1. Create betalane.json on the root of your project.

    1. .
    2. ├── Example
    3. ├── Example.xcodeproj
    4. └── betalane.json

  2. Confgiure lane and jobs in betalane.json file as shown in the following example

  1. [
  2.   {
  3.     "laneName": "beta",
  4.     "jobs": [
  5.       {
  6.         "job": "cli",
  7.         "options": {
  8.           "cmd": "cd Example && carthage update --platform iOS"
  9.         }
  10.       },
  11.       {
  12.         "job": "build",
  13.         "options": {
  14.           "scheme": "Example-Dev",
  15.           "provisioningProfile": "e9890938-67cd-4e01-a197-7a43c2e355a4"
  16.         }
  17.       }
  18.     ]
  19.   }
  20. ]
  1. Add .betalane to your .gitignore file
  1. # Betalane processing directory
  2. .betalane

In action…

From the root of your project execute the following command 

  1. $ betalane [lane] [job]

Example 1 - excute all lanes and all jobs

  1. $ betalane

Example 2 - excute specific lane and all it’s jobs

  1. $ betalane beta

Example 3 - excute specific lane and specific job

  1. $ betalane beta build

Documentation

build - Building your app

  1. {
  2.   "job": "build",
  3.   "options": {
  4.     "scheme": "Example-Dev",
  5.     "target": "Example",
  6.     "buildConfiguration": "Debug",
  7.     "method": "development",
  8.     "signingCertificate": "iOS Developer",
  9.     "compileBitcode": "NO",
  10.     "provisioningProfile": "e9890938-67cd-4e01-a197-7a43c2e355a4"
  11.   }
  12. }

options : {

property Optional Description Default Available Options
scheme (Optional) Scheme <Project Name>
target (Optional) Target <Project Name>
buildConfiguration (Optional) Build Configuration Debug
compileBitcode (Optional) Should complie BitCode? NO YES, NO
method (Optional) Distribution Method development app-store, ad-hoc, development
signingCertificate (Optional) Certificate Auto Selected from Build Setting
provisioningProfile (Optional) Provisioning Profile Auto Selected from Build Settings Profile ID, Profile Name

}

Output Params

Params Description Sample Value
BL_BUILD_ARCHIVE_PATH Archive path /Users/jay.mehta/Example/.betalane/Example.xcarchive
BL_BUILD_IPA_PATH IPA File path /Users/jay.mehta/Example/.betalane/Example-Dev.ipa

doa_s3 - Distribute on the Air using AWS S3

  1. {
  2.   "job": "doa_s3",
  3.   "options": {
  4.     "AccessKeyID": "AKXXXXXXXXXEXAMPLE",
  5.     "SecretAccessKey": "wJXXXXXXXXXX/K7XXXXXX/XXXXXXXEXAMPLEKEY",
  6.     "s3Bucket": "example-beta-builds",
  7.     "region": "us-east-2",
  8.     "prefix": "builds/ios/",
  9.     "buildPath" : "env.BL_BUILD_IPA_PATH"
  10.   }
  11. }

options : {

property Optional Description Default Available Options
AccessKeyID Required AccessKeyID - Obtain from IAM
SecretAccessKey Required SecretAccessKey - Obtain from IAM
s3Bucket Required AWS S3 Bucket Name
region Required AWS S3 Bucket Region
prefix (Optional) S3 Key Prefix betalane/
buildPath (Optional) Build Path to upload on S3 env.BL_BUILD_IPA_PATH - Env variable exposed by build job

}

Output Params

Params Description Sample Value
BL_DOA_S3_BUILD_URL Build Url https://example-beta-builds.s3.amazonaws.com/doa-beta-20-Aug-2018-14-40-58/package.ipa
BL_DOA_S3_MANIFEST_URL Menifest Url https://example-beta-builds.s3.amazonaws.com/doa-beta-20-Aug-2018-14-40-58/manifest.plist
BL_DOA_S3_INSTALL_URL Installable Url https://example-beta-builds.s3.amazonaws.com/doa-beta-20-Aug-2018-14-40-58/download.html

IAM Policy Sample

  1. {
  2.   "Version": "2012-10-17",
  3.   "Statement": [
  4.     {
  5.       "Sid": "StmtBetalaneS3Policy",
  6.       "Action": [
  7.         "s3:PutObject",
  8.         "s3:PutObjectAcl"
  9.       ],
  10.       "Effect": "Allow",
  11.       "Resource": "arn:aws:s3:::example-beta-builds/*"
  12.     }
  13.   ]
  14. }

Steps to create S3 bucket

  1. Login to AWS Console
  2. Click on S3 service
  3. Create Bucket
  4. Enter “Bucket Name”, Click “Next”, “Next”, “Next”, “Cerate Bucket”.

Steps to create IAM User

  1. Login to AWS Console
  2. Click on IAM service
  3. Select Policies from left side menu
  4. Select “Create Policy”
  5. Click on “JSON” tab
  6. Replace JSON with above sample and change bucket name in Resource key
  7. Click “Review Policy”
  8. Name your policy, e.g. Example Beta Lane S3 Policy
  9. Click “Create Policy”
  10. Now select “Users” from left side menu
  11. Click “Add User”
  12. Give some “Username”, and select “Programmatic access” from Access Type.
  13. Select “Attach Existing Policy”
  14. Look for the policy you just created and select it, Click “Next: Review”
  15. Review and Click “Create”
  16. Download CSV file containing your AccessKeyID and SecretAccessKey

cli - Execute any cli command

  1. {
  2.   "job": "cli",
  3.   "options": {
  4.     "cmd": "cd Example && carthage update --platform iOS"
  5.   }
  6. }

options : {

property Optional Description Default Available Options
cmd Required Command to be performed

}