इस प्रोजेक्ट के बारे में

App Store Connect CLI (`asc`) एक तेज़, स्क्रिप्टेबल कमांड-लाइन टूल है जो iOS, macOS, tvOS और visionOS प्लेटफ़ॉर्म पर App Store Connect वर्कफ़्लो को स्वचालित करता है। ### इंस्टॉलेशन - Homebrew: `brew install asc` - इंस्टॉल स्क्रिप्ट: `curl -fsSL https://asccli.sh/install | bash` - WinGet: `winget install Rorkai.ASC --exact` - रिलीज़ बाइनरी GitHub releases से उपलब्ध हैं; सोर्स बिल्ड के लिए go.mod में घोषित Go संस्करण आवश्यक है। ### प्रमाणीकरण API कुंजियाँ appstoreconnect.apple.com पर जनरेट की जाती हैं। इसके साथ प्रमाणित करें: ```bash asc auth login --name "MyApp" --key-id "ABC123" --issuer-id "DEF456" --private-key /path/to/AuthKey.p8 --network ``` व्यक्तिगत API कुंजियाँ `--issuer-id` को छोड़ देती हैं और `--key-type individual` का उपयोग करती हैं। CI या हेडलेस वातावरण के लिए, `--bypass-keychain` पास करें। `asc auth status --validate` या `asc auth doctor` से सत्यापित करें। ### आउटपुट डिफ़ॉल्ट `asc` इंटरैक्टिव टर्मिनल में `table` आउटपुट और पाइप/CI में `json` का उपयोग करता है। `ASC_DEFAULT_OUTPUT` के माध्यम से विश्व स्तर पर या प्रति-कमांड `--output json --pretty` के साथ ओवरराइड करें। ### सामान्य वर्कफ़्लो **TestFlight और बिल्ड:** ```bash asc apps list --output table asc builds upload --app "APP_ID" --ipa "/path/to/MyApp.ipa" asc testflight groups list --app "APP_ID" ``` **App Store सबमिशन:** ```bash asc publish appstore --app "APP_ID" --ipa "/path/to/MyApp.ipa" --version "1.2.3" --submit --confirm asc status --app "APP_ID" --watch ``` **सत्यापन और समीक्षा:** ```bash asc validate --app "APP_ID" --version "1.2.3" asc review status --app "APP_ID" asc validate --app "APP_ID" --version "1.2.3" --deep ``` डीप सत्यापन इंटरैक्टिव प्रॉम्प्ट के बिना Apple के साइन-इन वेब एंडपॉइंट के माध्यम से App Privacy, समझौतों और सब्सक्रिप्शन अटैचमेंट की जाँच करता है। **मेटाडेटा और स्थानीयकरण:** ```bash asc localizations list --app "APP_ID" --type app-info asc metadata apply --app "APP_ID" --version "1.2.3" --dir "./metadata" --dry-run asc metadata keywords audit --app "APP_ID" --version "1.2.3" --blocked-terms-file "./blocked-terms.txt" ``` कीवर्ड ऑडिटिंग डुप्लिकेट, ऐप नाम/सबटाइटल के साथ ओवरलैप, बाइट-बजट उपयोग और ब्लॉक किए गए शब्दों की रिपोर्ट करती है। **स्क्रीनशॉट और मीडिया:** ```bash asc screenshots plan --app "APP_ID" --version "1.2.3" --review-output-dir "./screenshots/review" asc screenshots apply --app "APP_ID" --version "1.2.3" --review-output-dir "./screenshots/review" --confirm ``` JSONC प्लान फ़ाइल के माध्यम से डिवाइस, लोकेल और अपीयरेंस में मैट्रिक्स-आधारित स्क्रीनशॉट कैप्चर समर्थित है। **साइनिंग और बंडल ID:** ```bash asc bundle-ids capabilities list --bundle "BUNDLE_ID" asc signing fetch --bundle-id com.example.app --profile-type IOS_APP_STORE --output .asc/signing asc signing sync pull --repo [email protected]:team/signing.git --password-file ~/.config/asc/signing-sync-password --output-dir .asc/signing/pulled ``` `signing fetch` प्रमाणपत्र और प्रोविजनिंग प्रोफ़ाइल डाउनलोड करता है। `signing sync` एन्क्रिप्टेड Git स्टोर के माध्यम से पहचान साझा करता है। एक ही पास में गुम कुंजी/प्रमाणपत्र/प्रोफ़ाइल जनरेट करने के लिए `--create-missing` का उपयोग करें। **वर्कफ़्लो ऑटोमेशन:** ```bash asc workflow validate --output json asc workflow run --dry-run testflight_beta VERSION:1.2.3 ``` **Xcode Cloud:** ```bash asc xcode-cloud run --workflow-id "WORKFLOW_ID" --pull-request-id "PR_ID" asc xcode-cloud build-runs get --id "BUILD_RUN_ID" ``` **Apple Ads और StoreKit:** Apple Ads कैंपेन और StoreKit Retention Messaging के लिए अलग OAuth क्रेडेंशियल का उपयोग किया जाता है। सेटअप के लिए `asc ads auth login` और `asc storekit auth login` देखें। ### एजेंट स्किल्स 25 समीक्षित `asc` ऑटोमेशन स्किल्स https://github.com/rorkai/app-store-connect-cli-skills पर उपलब्ध हैं। `asc install-skills` के साथ विश्व स्तर पर इंस्टॉल करें, जो चेकआउट किए गए कमिट को पिन करता है और प्रत्येक फ़ाइल को सत्यापित करता है। ### गोपनीयता और टेलीमेट्री विश्वसनीयता ट्रैक करने में मेंटेनर्स की सहायता के लिए डिफ़ॉल्ट रूप से छद्म-नाम कमांड-स्तरीय टेलीमेट्री भेजी जाती है। इवेंट में CLI संस्करण, OS, आर्किटेक्चर, कमांड पथ, अवधि और विफलताओं पर HTTP स्थिति शामिल है। इनमें कच्चे आर्गुमेंट, क्रेडेंशियल, Apple खाता पहचानकर्ता, बंडल ID और फ़ाइल पथ शामिल नहीं हैं। `ASC_TELEMETRY_DISABLED=1`, `DO_NOT_TRACK=1`, या `asc telemetry disable` के साथ अक्षम करें। ### दस्तावेज़ीकरण - `docs/CI_CD.md` — GitHub Actions, GitLab, Bitrise, CircleCI एकीकरण - `docs/WORKFLOWS.md` — स्थानीय Xcode से TestFlight पैटर्न - `commands/signing.mdx` — साइनिंग पहचान सेटअप और CI रोटेशन - `guides/apple-ads-playbooks.mdx` — Apple Ads ऑपरेटर गाइड - `docs/API_NOTES.md` — API विशेषताएँ और व्यवहार - `docs/PARITY.md` — शेष समानता क्षेत्र अंतर्निहित सहायता प्रामाणिक है: `asc <command> --help`। लाइसेंस: MIT। अनौपचारिक टूल, Apple Inc. से संबद्ध नहीं।