Skip to content

Commit a8fbcc6

Browse files
docs: regenerate llms.txt and llms-full.txt
1 parent 12efcea commit a8fbcc6

1 file changed

Lines changed: 29 additions & 5 deletions

File tree

docs/llms-full.txt

Lines changed: 29 additions & 5 deletions
Original file line numberDiff line numberDiff line change
@@ -926,7 +926,7 @@ macOS {
926926

927927
notarization {
928928
appleID.set("dev@example.com")
929-
password.set("@keychain:AC_PASSWORD")
929+
password.set(System.getenv("MAC_NOTARIZATION_PASSWORD"))
930930
teamID.set("TEAMID")
931931
}
932932
}
@@ -1988,15 +1988,15 @@ macOS {
19881988

19891989
### Notarization
19901990

1991-
Apple notarization is required for distributing outside the Mac App Store on macOS 10.15+. Two authentication modes are supported (mutually exclusive — App Store Connect API key support is planned):
1991+
Apple notarization is required for distributing outside the Mac App Store on macOS 10.15+. Three authentication modes are supported (mutually exclusive):
19921992

19931993
#### Mode 1 — Apple ID + app-specific password
19941994

19951995
```kotlin
19961996
macOS {
19971997
notarization {
19981998
appleID.set("dev@example.com")
1999-
password.set("@keychain:AC_PASSWORD")
1999+
password.set(System.getenv("MAC_NOTARIZATION_PASSWORD"))
20002000
teamID.set("TEAMID")
20012001
}
20022002
}
@@ -2007,7 +2007,7 @@ Equivalent Gradle properties:
20072007
| Gradle property | Description |
20082008
|-----------------|-------------|
20092009
| `compose.desktop.mac.notarization.appleID` | Apple ID email |
2010-
| `compose.desktop.mac.notarization.password` | App-specific password (or `@keychain:` reference) |
2010+
| `compose.desktop.mac.notarization.password` | App-specific password |
20112011
| `compose.desktop.mac.notarization.teamID` | Apple Team ID |
20122012

20132013
#### Mode 2 — `notarytool` keychain profile
@@ -2038,7 +2038,31 @@ Equivalent Gradle properties:
20382038
| `compose.desktop.mac.notarization.keychainProfile` | Profile name created via `store-credentials` |
20392039
| `compose.desktop.mac.notarization.keychainPath` | Optional path to the keychain holding the profile |
20402040

2041-
> Configuring both modes in the same build is rejected at validation time. Pick one.
2041+
#### Mode 3 — App Store Connect API key
2042+
2043+
Generate a key in [App Store Connect → Users and Access → Integrations → Team Keys](https://appstoreconnect.apple.com/access/integrations/api), download the `.p8` file once, then reference it:
2044+
2045+
```kotlin
2046+
macOS {
2047+
notarization {
2048+
apiKey.set("/path/to/AuthKey_ABC123.p8")
2049+
apiKeyId.set("ABC123") // 10-char Key ID
2050+
apiIssuer.set("12345678-90ab-cdef-1234-567890abcdef") // Issuer UUID
2051+
}
2052+
}
2053+
```
2054+
2055+
Equivalent Gradle properties:
2056+
2057+
| Gradle property | Description |
2058+
|-----------------|-------------|
2059+
| `compose.desktop.mac.notarization.apiKey` | Path to the `.p8` API key file |
2060+
| `compose.desktop.mac.notarization.apiKeyId` | Key ID (the 10-character identifier) |
2061+
| `compose.desktop.mac.notarization.apiIssuer` | Issuer UUID for the team |
2062+
2063+
This mode is recommended for CI/CD: API keys can be revoked independently of the Apple ID, support role-based scoping, and are not affected by 2FA.
2064+
2065+
> Configuring more than one mode in the same build is rejected at validation time. Pick one.
20422066

20432067
### CI/CD: macOS Signing
20442068

0 commit comments

Comments
 (0)