נקודות מפתח
חיבור מערכי CI/CD ל-APIs של ההפצה מבטל את הצורך בהזנת נתונים ידנית במהלך עדכוני אפליקציות. Fastlane Deliver ו-Supply נותרו תקן התעשייה להזרקת מטא-דאטה מותאם לשפה באופן מאובטח. מערכות לוקליזציה מבוססות AI יכולות לתרגם מיד את הערות השחרור ליותר מ-35 שפות נתמכות. מודלי שפה גדולים (LLMs) המשולבים ישירות בתהליכי ה-Git שלכם מתרגמים באופן אוטומטי הודעות commit טכניות לטקסט המיועד למשתמש. אוטומציה של לוקליזציה ב-App Store Connect מונעת שגיאות עיצוב אנושיות בעת עדכון יומני שינויים מרובי פלטפורמות.
שחרור עדכון למובייל אמור להיות תהליך פשוט בלחיצת כפתור. במקום זאת, מפתחים מבלים שעות בהעתקה והדבקה ידנית של יומני שינויים מתורגמים לתוך ממשקי רשת נוקשים עבור כל שפה. הטמעת אוטומציה של הערות שחרור לאפליקציות יוצרת מערכת אמינה שכותבת, מתרגמת ופורסת מטא-דאטה לשחרור לצד קבצי ההרצה המקומפלים (binaries).
כיצד להגדיר אוטומציה של הערות שחרור ב-App Store?
אפשר להפוך את הערות השחרור לאוטומטיות ב-App Store על ידי קישור ה-CI/CD שלכם ישירות ל-APIs של המפתחים של Apple ו-Google. המערך המקושר הזה מושך טקסט מה-repository שלכם ודוחף אותו לעמוד החנות במהלך תהליך הבילד.
התייחסו למטא-דאטה של החנות בדיוק כמו לקוד האפליקציה. על ידי שמירת הערות השחרור ב-Git, אתם מבטיחים בקרת גרסאות ויכולת לאתר עדכונים ביחס לגרסאות אפליקציה ספציפיות. תיוג (Tagging) של שחרור יגרום לפלטפורמות כמו GitHub Actions להריץ סקריפט פריסה.
הסקריפט הזה מבצע אימות מול שרתי הפלטפורמה, ומעלה את חבילת האפליקציה יחד עם קובצי טקסט ספציפיים לכל שפה (למשל, en-US, fr-FR). הסקריפט האוטומטי עובר על התיקיות האלה, וממפה את חבילת הטקסט לשדות השפה הרלוונטיים במסד הנתונים של חנות האפליקציות.
על פי הנחיות המפתחים של Apple, תחזוקת לוקליזציה מדויקת בכל האזורים היא גורם מפתח בגידול היקף ההורדות העולמי. אוטומציה תכנותית מבטלת שגיאות אנוש ומבטיחה שקהלים ברחבי העולם יקבלו עדכוני פיצ'רים מדויקים.
האם ניתן להפוך הערות שחרור ל-iOS לאוטומטיות בעזרת Fastlane?
כן, תוכלו להפוך הערות שחרור של iOS לאוטומטיות באמצעות Fastlane Deliver, להעלאת קובצי טקסט פשוטים ישירות ל-App Store Connect. הכלי Deliver יוצר מבנה תיקיות מקומי המשקף וממפה באופן מושלם את שדות המטא-דאטה של Apple.
Fastlane פועל כמתווך בין סביבת ה-CI שלכם לשרתים של Apple. הרצת fastlane init מייצרת תיקיית fastlane/metadata המכילה תתי-תיקיות לכל שפה נתמכת. בתוך תיקיית שפה ספציפית, פשוט צרו קובץ release_notes.txt.
הרצת fastlane deliver מבצעת אימות מאובטח באמצעות מפתח API של App Store Connect, קוראת את release_notes.txt, ומעדכנת את השדה "מה חדש בגרסה זו" (What's New in This Version). ניתן להפעיל תהליך עבודה זה דרך תצורת lane מותאמת אישית של Fastlane על ידי הגדרת מפתח API, הוספת פעולת ה-deliver, ולחלופין העברת submit_for_review: true כדי להגיש מידית את האפליקציה לביקורת (review).
שימוש ב-Fastlane נותר השיטה העמידה ביותר לביצוע אוטומציה של הערות שחרור לאפליקציות iOS ללא כתיבת סקריפטי רשת מותאמים אישית מאפס. הוא משתלב בצורה חלקה בתהליכי עבודה המייצרים קובצי טקסט אלו באופן דינמי.
כיצד לתרגם הערות שחרור לאפליקציות באופן אוטומטי?
תוכלו לתרגם הערות שחרור באופן אוטומטי על ידי חיבור תהליך יצירת הטקסט שלכם ל-API של תרגום מבוסס AI, או על ידי שימוש בתוסף מפתחים ישירות בתוך App Store Connect. כלים אלו ממפים את העדכונים משפת המקור לשפות היעד ברחבי העולם באופן מיידי.
בעבר, תהליכי לוקליזציה (L10n) דרשו ניהול קובצי CSV ענקיים ועבודה מול סוכנויות תרגום. כיום, סקריפטים יכולים לשלוח הערות שחרור באנגלית ל-OpenAI API או ל-Google Cloud Translation API. התשובות המתורגמות נשמרות לאחר מכן לתוך תיקיות Fastlane ומוכנות להעלאה.
מכיוון שסקריפטי API מותאמים דורשים כוונון של פרומפטים ותחזוקת מפתחות API, כלי דפדפן מציעים חלופה יעילה. StoreManager מציע אוטומציה ללוקליזציה של App Store Connect בלמעלה מ-35 שפות תוך שימוש ב-Gemini AI ישירות בתוך הדפדפן שלכם. מזינים טקסט מקור, והתוסף מפיץ את התרגומים על פני כל השפות המוגדרות באופן מיידי.
בנוסף, StoreManager מייעל משימות קונסולה אחרות. מעבר ליצירת טקסט מרובה שפות, הוא מגדיר תמחור מבוסס PPP ליותר מ-175 טריטוריות. הבחירה בין סקריפטים כחלק ממערך הפיתוח לבין אוטומציית דפדפן תלויה אך ורק בהעדפה הטכנית שלכם לתחזוקת קוד מותאם אישית.
כיצד להגדיר אוטומציה להערות שחרור ב-Google Play Store?
אפשר לאטמט את הערות השחרור ב-Google Play Store באמצעות Fastlane Supply או קריאות ישירות ל-Google Play Developer API. גוגל פליי אוכפת מבנה קבצים קפדני שכלי האוטומציה שלכם חייב לעקוב אחריו במדויק.
כדי ליצור אוטומטית הערות שחרור לאנדרואיד, ארגנו את קובצי הטקסט שלכם בתוך Fastlane תוך שימוש במוסכמות שמות הקשורות ל-version code של הבילד. מקמו את הערות השחרור שלכם ב-fastlane/metadata/android/en-US/changelogs/.
שם הקובץ חייב להתאים למספר השלם (integer) המייצג את גרסת חבילת האפליקציה (לדוגמה, 10045.txt), או השתמשו ב-default.txt כדי להחיל את אותו טקסט על כל ההעלאות. גוגל פליי אוכפת מגבלה נוקשה של 500 תווים להערות שחרור באנדרואיד. תהליך האוטומציה שלכם חייב לכלול שלבי ולידציה לקיצוץ או סיכום של הטקסט עבור אנדרואיד כדי למנוע כשלונות בתהליך הפריסה.
הרצת fastlane supply מתחברת דרך מפתח JSON של חשבון שירות (Service Account) ב-Google Cloud. הפקודה מעלה את ה-AAB שלכם ודוחפת ברצף קובצי טקסט מתורגמים לתוך קונסולת ה-Google Play, ומפרסמת את העדכון באופן מיידי.
האם AI יכול לכתוב הערות שחרור לחנות האפליקציות?
כן, AI יכול לכתוב הערות שחרור לחנות האפליקציות על ידי קליטת היסטוריית ה-Git commits שלכם ושימוש במודלי שפה גדולים כדי לסכם שינויים טכניים גולמיים. שלבו את פרומפט ה-AI ישירות בתהליך ה-CI שלכם לפני שלב העלאת המטא-דאטה.
מפתחים כותבים בדרך כלל הודעות commit טכניות במיוחד. המשתמשים שקוראים את התיאור ב-App Store לא מתעניינים בארגון מחדש (refactors) של הקוד הפנימי; אכפת להם משיפורי אבטחה ומהירות. הגדירו GitHub Action שיאסוף את כל הודעות ה-commit שבין תיוג השחרור (release tag) הנוכחי לקודם.
סקריפט ה-Pipeline שלכם שולח את מחרוזת ה-commits המרוכזת הזו לנקודת קצה (Endpoint) של AI, כאשר פרומפט מורה למודל לתרגם את הז'רגון הטכני לתועלות ברורות למשתמש. ה-AI יחזיר הערות שחרור מלוטשות שנוצרו על ידי AI, והסקריפט שלכם יכתוב אותן אוטומטית לקובץ ה-release_notes.txt. גישה זו מבליטה תוספות אמיתיות של פיצ'רים מבלי לדרוש מהמפתחים לעצור את עבודתם כדי לכתוב תוכן שיווקי.
כיצד להשתמש ב-App Store Connect API לצורך עדכונים?
כדי להשתמש ב-App Store Connect API יש לבצע קריאות רשת מרושתות ומאומתות מסוג REST אל ה-endpoint appStoreVersionLocalizations, על מנת לעדכן את שדה הנתונים whatsNew. גישה זו עוקפת כלים מתווכים כמו Fastlane, ומעניקה שליטה מלאה על התשתית שלכם.
ה-API של Apple דורש אימות קפדני, מה שאומר שאתם חייבים לייצר JSON Web Token (JWT) תוך שימוש במפתח פרטי מחשבון ה-App Store Connect שלכם. סקריפט הפריסה שלכם חותם על הטוקן ומצרף אותו לכותרת ההרשאה (Authorization Header) בבקשת ה-HTTP. כדי לעדכן שפה מסוימת, עליכם תחילה לתשאל את ה-API כדי למצוא את המזהה הפנימי (Internal ID) של השפה עבור גרסת האפליקציה הממתינה שלכם.
שלחו בקשת HTTP PATCH ל-https://api.appstoreconnect.apple.com/v1/appStoreVersionLocalizations/{id} עם נתוני JSON שמפרטים את המחרוזת המעודכנת עבור whatsNew. שימוש ישיר ב-API הוא מהיר להפליא, ומאפשר לכם לאטמט עדכונים ב-app store connect באופן סינכרוני. עם זאת, הוא דורש שתטפלו בעצמכם בלוגיקת השגיאות, הגבלות הקצב (rate limits), ופענוח ה-JSON (parsing).
מהי הדרך הטובה ביותר לבצע לוקליזציה להערות שחרור?
הדרך הטובה ביותר לתרגם (לעשות לוקליזציה) להערות השחרור תלויה בקצב השחרורים שלכם: השתמשו בכלי אוטומציה ישירים בדפדפן עבור עדכונים מיידיים, או במידה ויש שחרורים מתוזמנים, בנו מערך CI/CD מבוסס סקריפטים במלואו. שתי השיטות מבטלות את הצורך בהזנת נתונים ידנית.
בניית אינטגרציה מותאמת אישית של API מציעה את הגמישות המרבית, אך היא דורשת תחזוקה מתמשכת כאשר הפלטפורמות מעדכנות את נקודות הקצה שלהן. שימוש בתוסף מפשט משמעותית את תהליך העבודה.
| שיטת לוקליזציה | זמן הקמה | עומס תחזוקה | התרחיש המומלץ ביותר |
|---|---|---|---|
| הזנה ידנית | כלל לא | גבוה מאוד | אפליקציות בשפה אחת בלבד |
| Fastlane CI/CD | גבוה | בינוני | צוותי ארגונים (Enterprise) עם שרתים מותאמים אישית |
| אוטומציית דפדפן | נמוך | נמוך | מפתחי אינדי ואיטרציות מהירות |
כדי לעקוף לחלוטין את הצורך בתחזוקת Pipeline, תוספי דפדפן מספקים ערך מיידי. תוכלו לתרגם את הערות השחרור לאפליקציה באופן אוטומטי באמצעות StoreManager, ישירות מדשבורד הקונסולה של Apple שלכם. ללא קשר לכלי שייבחר, המעבר מהזנת טקסט ידנית הוא שלב הכרחי להגדלת טביעת הרגל הגלובלית של האפליקציה שלכם ביעילות.
שאלות נפוצות
מהי מגבלת התווים להערות שחרור ב-App Store?
אפל אוכפת מגבלה נוקשה של 4,000 תווים לכל היותר עבור סעיף ה-'מה חדש בגרסה זו' ב-App Store Connect. גוגל פליי אוכפת מגבלה מחמירה בהרבה של 500 תווים להערות שחרור של אנדרואיד. סקריפטי האוטומציה שלכם חייבים לכבד את המגבלות האלו כדי למנוע שגיאות העלאה.
האם תרגום הערות השחרור משפר את ה-ASO?
כן, הערות שחרור מותאמות שפה (Localized) משפרות משמעותית את אופטימיזציית חנות האפליקציות (ASO). הצגת הערות שחרור בשפת האם של המשתמש מפחיתה את אחוזי הנטישה בעמוד החנות, משפרת את הקריאות, ומגדילה את אחוזי ההמרה העולמיים, מה שמוביל ליותר הורדות ברחבי העולם.
האם אוכל להשתמש ב-Markdown או ב-HTML בהערות השחרור שלי?
לא אפל ולא גוגל תומכות במלואן ברינדור HTML גולמי בהערות שחרור. אפל תומכת אך ורק בטקסט פשוט (plain text) ומתעלמת מעיצוב markdown. גוגל מאפשרת תגיות עיצוב בסיסיות מאוד, כמו לטקסט מודגש, אבל HTML מורכב יוצג כטקסט גולמי.
באיזו תדירות כדאי לעדכן את הערות השחרור לאפליקציה?
מומלץ לעדכן את הערות השחרור שלכם עבור כל פריסה לסביבת ייצור (Production) המכילה שינויים גלויים למשתמש, תיקוני באגים, או שיפורי ביצועים. במחזורי פיתוח מודרניים המנצלים אוטומציה, זה קורה בדרך כלל כל שבוע או שבועיים לצד שחרורי ספרינט רגילים.
מקורות
- תיעוד המפתחים של Apple, תיעוד רשמי של ה-API לעדכון הלוקליזציות של גרסאות האפליקציה בחנות דרך קריאות REST.
- Google Play Developer API, תיעוד המפרט את ה-Edits API הנדרש להעלאת App Bundles לאנדרואיד ומטא-דאטה.
- Fastlane Deliver, הוראות הגדרה מקיפות למיפוי קובצי טקסט מקומיים לשדות App Store Connect ב-iOS.
- Fastlane Supply, הנחיות תצורה לדחיפת יומני שינויים (changelogs) מותאמי שפה לחנות של Google Play.
- תיעוד של GitHub Actions, שיטות עבודה מומלצות ליצירת תהליכי עבודה אוטומטיים המופעלים על ידי תיוגים (Tags) ממאגר ה-Git.
- פלטפורמת המפתחים של OpenAI, מדריך ה-API לשילוב מודלי שפה גדולים לעיצוב ותרגום היסטוריית ה-commits.
