使用此工作來安裝在 macOS 代理程式上建置所需的 Apple 憑證。 您可以使用這項工作來安裝儲存為伺服器上 安全檔案 的 Apple 憑證。
語法
# Install Apple Certificate v1
# Install an Apple certificate required to build on a macOS agent.
- task: InstallAppleCertificate@1
inputs:
certSecureFile: # string. Required. Certificate (P12).
#certPwd: # string. Certificate (P12) password.
# Advanced
keychain: 'temp' # 'default' | 'temp' | 'custom'. Required. Keychain. Default: temp.
#keychainPassword: # string. Keychain password.
#customKeychainPath: # string. Required when keychain = custom. Custom keychain path.
#deleteCert: # boolean. Optional. Use when keychain = custom || keychain = default. Delete certificate from keychain.
#deleteCustomKeychain: # boolean. Optional. Use when keychain = custom. Delete custom keychain.
#signingIdentity: # string. Certificate signing identity.
輸入
certSecureFile
-
憑證 （P12）
string。 必須的。
指定上傳至 Secure Files 以安裝在macOS代理程式的憑證 （.p12）。
certPwd
-
憑證 （P12） 密碼
string。
指定 Apple 憑證的密碼 （.p12）。 使用新的組建變數，並在 [Variables] 索引標籤上啟用其鎖定，以加密此值。
keychain
-
Keychain
string。 必須的。 允許的值：default（預設金鑰鏈）、temp（暫存密鑰鏈）、custom（自定義密鑰鏈）。 預設值：temp。
指定要在其中安裝Apple 憑證的金鑰鏈。 建置或發行完成後，一律會刪除暫存密鑰鏈。
keychainPassword
-
金鑰鏈密碼
string。
指定要解除鎖定金鑰鏈的密碼。 使用新的組建變數，並在 [Variables] 索引標籤上啟用其鎖定，以加密此值。 如果尚未指定密碼，則會為暫存密鑰鏈產生密碼。
customKeychainPath
-
自定義金鑰鏈路徑
string。
keychain = custom時為必要項。
指定自訂金鑰鏈檔案的完整路徑。 如果金鑰鏈不存在，則會建立金鑰鏈。
deleteCert
-
從金鑰鏈刪除憑證
boolean。 選擇性。
keychain = custom || keychain = default時使用 。
指定要在建置或發行完成後從金鑰鏈中刪除的憑證。
deleteCustomKeychain
-
刪除自定義金鑰鏈
boolean。 選擇性。
keychain = custom時使用 。
指定要在組建或發行完成後從代理程序刪除的自定義金鑰鏈。
signingIdentity
-
憑證簽署身分識別
string。
指定簽署憑證中主體的 Common Name。 如果保留空白，則會嘗試剖析 Common Name。
工作控制選項
除了工作輸入之外，所有工作都有控制選項。 如需詳細資訊，請參閱 控制項選項和一般工作屬性。
輸出變數
此工作會定義下列 輸出變數，您可以在下游步驟、作業和階段中取用這些變數。
signingIdentity
指定簽署憑證中主體的已解析 Common Name。 提供做為輸入，或從 P12 憑證檔案剖析。
keychainPath
使用憑證指定金鑰鏈檔案的路徑。