منصوبے کے بارے میں

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 ریلیز سے دستیاب ہیں؛ سورس بلڈز کے لیے 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 ``` گہری توثیق App Privacy، معاہدوں اور سبسکرپشن منسلکات کو Apple کے سائن ان شدہ ویب اینڈ پوائنٹس کے ذریعے بغیر انٹرایکٹو پرامپٹس کے چیک کرتی ہے۔ **میٹا ڈیٹا اور لوکلائزیشن:** ```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 پلان فائل کے ذریعے سپورٹ ہے۔ **سائننگ اور بنڈل IDs:** ```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 اکاؤنٹ شناخت کنندگان، بنڈل IDs اور فائل پاتھ شامل نہیں ہیں۔ `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. سے منسلک نہیں۔