გადადით შინაარსზე

Gradle-ის პრევიუები

ააწყვეთ და გააზიარეთ Android აპლიკაციები და ნეიტიური კომანდური ხაზის ინსტრუმენტები პირდაპირ Gradle-დან. დაიწყეთ Gradle პროექტის სახელმძღვანელოთი პროექტის დასაკავშირებლად და ავტორიზაციისთვის.

Android აპლიკაციები#

bash
./gradlew :app:tuistShareDebug

dev.tuist პარამეტრების პლაგინი რეგისტრირებს tuistShare<Variant> ამოცანას თითოეული აპლიკაციის ვარიანტისთვის Android Gradle Plugin-იდან (8.8.2 ან უფრო გვიანი). შეცვალეთ app და Debug თქვენი აპლიკაციის მოდულითა და ვარიანტით, მაგალითად :app:tuistShareDemoDebug პროდუქტის ფლეივორისთვის. ამოცანა ააწყობს APK-ს Gradle-ის მიერ განაცხადებული არტეფაქტის დამოკიდებულებების მეშვეობით მის გამოქვეყნებამდე. ის ასევე მუშაობს, როდესაც ბილდის გამოსავალი აქტუალურია ან აღდგენილია ბილდის ქეშიდან.

მხარდაჭერილია მხოლოდ ერთი, ხელმოწერილი, უნივერსალური აპლიკაციის APK. Android-ის debug ვარიანტი ჩვეულებრივ იყენებს debug ხელმოწერის გასაღებს; release ვარიანტებს სჭირდებათ თქვენი საკუთარი ხელმოწერის კონფიგურაცია. ამოცანა ამოწმებს APK ხელმოწერას ავტორიზაციამდე ან ატვირთვამდე. ხელმოუწერელი, არასწორი, ინსტრუმენტული და გაყოფილი APK უარყოფილია. ბიბლიოთეკის მოდულები, ტესტის APK და Android App Bundles (.aab) არ არის გამოქვეყნების სამიზნეები.

ნეიტიური კომანდური ხაზის ინსტრუმენტები#

პროექტები, რომლებიც იყენებენ Gradle-ის cpp-application ან swift-application პლაგინს, იღებენ გაზიარების ამოცანას თითოეული ნეიტიური ბინარისთვის:

bash
./gradlew :app:tuistShareMainDebug

ამოცანა ააწყობს და აფუთავს ინსტალირებულ დისტრიბუციას, მისი გამშვებისა და შესრულების ბიბლიოთეკების ჩათვლით. გამოიყენეთ tuistShareMainRelease release ბინარისთვის. პროექტებს, რომლებიც რამდენიმე მანქანას ემიზნებიან, აქვთ ამოცანა თითოეული ბინარისთვის; გაუშვით ./gradlew :app:tasks --all მათი სახელების საპოვნელად.

მხარდაჭერილია ნეიტიური macOS და Linux შესრულებადი ფაილები arm64 ან x86_64-ისთვის. ააწყვეთ სამიზნე პლატფორმაზე თქვენი Gradle პლაგინისთვის საჭირო ინსტრუმენტთა ჯაჭვით. JVM აპლიკაციები და მათი გენერირებული გამშვები სკრიპტები არ არის მხარდაჭერილი ამ ინტეგრაციით.

გამოქვეყნების ქცევა#

გაზიარების ამოცანები აქვეყნებენ პლაგინის არსებული Tuist სერთიფიკატების გამოყენებით, Tuist CLI-ის გამოძახების გარეშე. ჩვეულებრივი assemble, build და ტესტის ამოცანები არასდროს აქვეყნებენ პრევიუებს.

გაზიარების შემდეგ, გახსენით Previews თქვენს პროექტში ბმულის დასაკოპირებლად. იგივე ბილდისა და ტრეკის გაზიარების განმეორება ხელახლა იყენებს მის გამოქვეყნებას, ბილდის ქეშში მოხვედრის შემდეგაც კი. წარუმატებელი ან დაუდასტურებელი ატვირთვები აფრუშებენ გაზიარების ამოცანას; ისინი არ არის მოხსენიებული, როგორც წარმატებული პრევიუები.

CI და ტრეკები#

კონფიგურირება CI ავტორიზაცია იმავე სერთიფიკატებით, რომლებსაც იყენებთ პლაგინის სხვა ავტორიზებულ ფუნქციებისთვის, შემდეგ მოითხოვეთ გამოქვეყნება ცალსახად:

bash
./gradlew :app:tuistShareDebug --track nightly

დაამატეთ --track nightly ნეიტიურ გაზიარების ამოცანას იმავე გზით. ამოცანები იყენებენ კონფიგურირებულ Tuist პროექტს, სერვერის URL-ს და პროქსის პარამეტრებს. პრევიუს გამოქვეყნება ყოველთვის მოითხოვს ავტორიზაციას. Git რევიზიის მეტამონაცემები, გამოშვების შენიშვნები და ავტომატური pull-request კომენტარები არ არის მიმაგრებული ამ ამოცანების მიერ.

არტეფაქტის გამოქვეყნებები იწურება 30 დღის შემდეგ hosted Tuist-ზე. Self-hosted ინსტანციები იყენებენ TUIST_APP_PREVIEW_RETENTION_DAYS; მისი დაუყენებლობა თიშავს ვადას ამ ოჯახისთვის. ვადაგასული გამოქვეყნებების აღდგენა შეუძლებელია იმავე ქმედების განმეორებით.

არსებული APK-ს გაზიარება#

APK-სთვის, რომელიც აწყობილია ამ სამუშაო პროცესის გარეთ, ან რათა ჩართოთ გამოშვების შენიშვნები ძველი ატვირთვის ნაკადთან, CLI რჩება ხელმისაწვდომი:

bash
tuist share app/build/outputs/apk/debug/app-debug.apk \
--track nightly --release-notes "Improve checkout"

იხილეთ Run a preview გამოქვეყნებული ბილდების გასაშვებად, წვდომისთვის, ტრეკებისთვის და README ბეჯებისთვის.

ტრეკები tuist share-ით#

სამუშაო პროცესებისთვის, რომლებიც აქვეყნებენ tuist share-ის საშუალებით, გამოიყენეთ --track ტრეკის არჩევას:

bash
tuist share App --track beta
tuist share App --track nightly

გამოშვების შენიშვნები#

გამოიყენეთ ტრეკები გარემოს ჯგუფებისთვის და გამოშვების შენიშვნები ცალკეული ბილდის მიზნებისთვის:

bash
tuist share App --track QA --release-notes "Fix sign-in and improve the checkout flow"

ჩაანაცვლეთ App თქვენი აპლიკაციის სახელით, აპლიკაციის ფაილის გზით ან შესრულებადი დისტრიბუციით და მისი --executable ოფციით. გამოშვების შენიშვნები არის სურვილისამებრ ჩვეულებრივი ტექსტი, 10 000 სიმბოლომდე. პირველი არაცარიელი ხაზი ჩანს ერთხაზიან ფრაგმენტად გადახედვების სიაში, ასე რომ ბილდის ნომრები და სხვა იდენტიფიცირების ინფორმაცია ერთი შეხედვით ჩანს. გრძელი ხაზები იკვეცება; სრული შენიშვნები ჩანს დეტალურ გვერდებზე. ძებნა ემთხვევა საჩვენებელ სახელებს და სრულ გამოშვების შენიშვნებს, მათ შორის ხაზებს, რომლებიც არ ჩანს ფრაგმენტში. მრავალხაზიანი შენიშვნები მხარდაჭერილია, მაგალითად --release-notes "$(< release-notes.txt)". ისინი არ ცვლიან აპლიკაციის საჩვენებელ სახელს ან მის ტრეკს.

თავსებადობა#

გამოშვების შენიშვნები არ ცვლიან, თუ რომელ გადახედვას ეკუთვნის ბილდი. პირველი შენიშვნები, რომელსაც გადახედვა იღებს, ინახება: მოგვიანებით ატვირთვას შეუძლია დაამატოს შენიშვნები გადახედვას, რომელსაც არ აქვს, მაგრამ ვერ გადაწერს ან წაშლის არსებულს. გადახედვები, რომლებიც აიტვირთა გამოშვების შენიშვნების არსებობამდე, რჩება ვალიდური მათ გარეშე.

თვითმასპინძელ განლაგებებს სჭირდებათ სერვერის ვერსია, რომელიც მხარს უჭერს გამოშვების შენიშვნებს და ტრეკის ფილტრაციას, განახლებულ კლიენტთან ერთად. ძველი სერვერები იგნორირებენ შენიშვნებს. სიის endpoint-ების ტრეკისა და ძებნის ფილტრებისთვის, იხილეთ API-ის ცნობარი.

Pull/merge request კომენტარები#

Git forge-ის ინტეგრაცია აუცილებელია

ავტომატური pull/merge request კომენტარების მისაღებად, დააკავშირეთ თქვენი დაშორებული პროექტი Git forge-თან.

მას შემდეგ, რაც თქვენი Tuist პროექტი დაკავშირდება თქვენს Git პლატფორმასთან, დაამატეთ tuist share CI-ში აპლიკაციის წარმატებული ბილდის შემდეგ. Tuist გამოაქვეყნებს გადახედვის ბმულს პირდაპირ თქვენს pull/merge request-ებში, ასე რომ შემმოწმებლებს შეეძლებათ ტესტირება ლოკალურად აშენების გარეშე:

GitHub app-ის კომენტარი Tuist Preview-ის ბმულით

ავტომატიზაციები#

გამოიყენეთ --json JSON გამოტანის მისაღებად tuist share-დან:

bash
tuist share --json

გამოიყენეთ შედეგი მორგებული ავტომატიზაციებისთვის, როგორიცაა Slack-ის შეტყობინების გამოქვეყნება CI-დან. url გასაღები შეიცავს სრულ გადახედვის ბმულს; qrCodeURL მიუთითებს QR კოდის გამოსახულებაზე გადახედვის მოწყობილობაზე გასახსნელად:

json
{
"id": 1234567890,
"url": "https://tuist.dev/preview/1234567890",
"qrCodeURL": "https://tuist.dev/preview/1234567890/qr-code.svg"
}