בניית קובץ ה-APK

בנייה עצמית במקום הורדה

יישום AndroidAPS אינו זמין להורדה מטעמי רגולציה של מכשירים רפואיים. בנייה עצמית של היישום לשימוש אישי הינה חוקית אך אסור לתת את היישום לאחרים! ראו שאלות נפוצות לפרטים.

הערות חשובות

סקירה כללית

באופן כללי, השלבים של בניית קובץ ה-APK הם:

  1. התקנת Git

  2. התקנת Android Studio

  3. הגדרת נתיב של Git בהעדפות Android Studio

  4. הורדת הקוד של AndroidAPS

  5. הורדת Android SDK

  6. בניית האפליקציה (יצירת apk חתום)

  7. העברת קובץ ה-apk לטלפון

  8. הגדרת זיהוי מקלט אם משתמשים ב-xDrip

מדריך שלב אחר שלב

תיאור מפורט של השלבים הדרושים לבניית קובץ ה-APK.

התקינו git (אם לא מותקן כבר)

עקבו אחר המדריך בדף התקנת של git.

התקנת Android Studio

צילומי המסך הבאים נלקחו מגרסת Android Studio Arctic Fox | 2020.3.1. המסכים עשויים להשתנות בגרסאות עתידיות של Android Studio. אף על פי כן, אתם צפויים להיות מסוגלים למצוא את דרככם. אפשר לקבל עזרה מהקהילה.

אחד הדברים החשובים ביותר בעת התקנת Android Studio: היו סבלניים! במהלך ההתקנה וההגדרה Android Studio מוריד הרבה דברים וזה לוקח זמן.

הורידו את Android Studio מכאן והתקינו אותו במחשבכם.

בפעם הראשונה יופיע אשף ההתקנה:

בחרו ”Do not import settings“ מכיוון שלא השתמשתם בו בעבר.

Do not import settings

החליטו אם ברצונכם לשתף נתונים עם Google או לא.

שיתוף מידע עם גוגל

במסך הבא לחץ על ”Next“.

מסך הכניסה

בחר בהתקנה ”Standard“ ולחצו על ”Next“.

התקנה סטנדרטית

בחרו את ערכת הנושא עבור ממשק המשתמש לנוחיותכם. (במדריך זה השתמשנו ב“Light“.) לאחר מכן לחצו על ”Next“.

הערה: זוהי רק סכמת צבעים. תוכלו לבחור את מה שתרצו (לדוגמה ”דרקולה“ שהוא צבע כהה). לבחירה זו אין השפעה על בניית ה-APK אך צילומי המסך הבאים עשויים להיראות אחרת.

צבעי ממשק משתמש

לחצו על ”Finish“ בתיבת הדו-שיח ”Verify Settings“.

אימות הגדרות

המתינו בזמן ש-Android Studio מוריד רכיבים נוספים והתאזרו בסבלנות. לאחר הורדת כל הרכיבים, כפתור ה-”Finish“ הופך לכחול. לחצו על הכפתור כעת.

מוריד רכיבים

הגדירו את נתיב git בהעדפות

ודאו שgit מותקן במחשבכם ושאתחלתם את המחשב לאחר ההתקנתו.

במסך הפתיחה של Android Studio לחצו על ”Customize“ (1) בצד שמאל ולאחר מכן בחרו בקישור ”All settings…“ (2):

הגדרות אנדרואיד סטודיו ממסך הכניסה

Windows

  • כמשתמשי Windows, ודאו שהפעלתם מחדש את המחשב לאחר התקנת Git.

  • לחצו פעמיים על ”Version Control“ (1) כדי לפתוח את תפריט המשנה.

  • לחצו על Git (2).

  • ודא ששיטת העדכון ”Merge“ (3.) נבחרה.

  • בדקו אם Android Studio יכול לאתר נתיב ל-git.exe באופן אוטומטי על ידי לחיצה על הכפתור ”Test“ (4).

    הגדרות אנדרואיד סטודיו

  • אם ההגדרה האוטומטית מצליחה תוצג גרסת git.

    גרסת גיט מוצגת

  • אם ניתן למצוא את git.exe באופן אוטומטי או שהבדיקה תגרום לשגיאה (1):

    גיט לא נמצא

    במקרה זה לחצו על סמל התיקיה (2).

  • השתמש בפונקציית חיפוש ב-Windows Explorer כדי למצוא את ”git.exe“ אם אינכם בטוחים היכן הותקן git. אתם מחפש קובץ בשם ”git.exe“, הממוקם בתיקייה \bin.

  • בחרו את הנתיב אל git.exe וודאו שבחרתם את זה שבתיקיית \bin\ (3.) ולחצו על ”OK“ (4).

    בחר גיט ידנית

  • בדקו שוב את נתיב ה-git שבחרת עם כפתור ”Test“ כמתואר לעיל.

  • כאשר גרסת git מוצגת לצד הנתיב (ראו צילום מסך למעלה), סגרו את חלון ההגדרות על ידי לחיצה על כפתור ”OK“ (5).

Mac

  • כל גרסה של git תתאים. לדוגמה https://git-scm.com/download/mac.

  • השתמשו ב-homebrew להתקנת git: $ brew install git.

  • לפרטים על התקנת git עיינו בתיעוד ה-git הרשמי.

  • אם אתם מתקינים git דרך homebrew אין צורך לשנות שום העדפות. ליתר ביטחון: ניתן למצוא אותם כאן: Android Studio > Preferences.

הורדת הקוד של AndroidAPS

  • במסך הפתיחה של Android Studio בחרו ”Projects“ (1) בצד שמאל ולאחר מכן ”Get from VCS“ (2).

    אנדרואיד סטודיו וויזרד

    • אם כבר פתחתם את Android Studio ולא רואים יותר את מסך הפתיחה בחרו File (1) > New (2) > Project from Version Control… (3)

      בדיקת פרויקט מפיקוח גרסה בתוך אנדרואיד סטודיו

    • כעת נגיד ל-Android Studio מאיפה להשיג את הקוד:

    • ודאו שבחרתם ב“Repository URL“ בצד שמאל (1).

    • בדוק אם ”Git“ נבחר ב-version control (2).

    • העתיקו והדביקו את כתובת האתר: https://github.com/nightscout/AndroidAPS למאגר הראשי של AndroidAPS לתוך תיבת הטקסט של URL (כתובת האתר) (3).

    • בחרו את הספרייה שבה ברצונכם לשמור את הקוד המשוכפל (4).

      שיבוט גיט

  • לחץ על כפתור ”Clone“ (5).

    מאגר השיבוט

  • אל תלחצו על ”Background“ בזמן שהמאגר משוכפל!

  • לאחר שכפול המאגר בהצלחה, Android Studio יפתח את הפרויקט המשוכפל.

  • אתם תישאלו אם אתם נותנים אמון בפרויקט. בחרו ”Trust project“!

    פרויקט מהימן

  • בשורת המצב בתחתית תראו את מידע על כך ש-Android Studio מפעיל משימות ברקע.

    משימות ברקע

  • העניקו גישה אם חומת האש (Firewall) שלכם מבקשת רשות.

    אישור חומת אש של ג'אוה

  • לאחר סיום משימות הרקע, סביר להניח שתראו שגיאה האומרת שהתרחשו שגיאות (1) או (2) או (3).

    רישוי SDK

    אל דאגה, תכף הן תטופלנה!

הורדת Android SDK

  • בתפריט, עבור אל File (1) > Settings (2).

    הגדרות פתוחות

  • לחצו פעמיים על Appearance & Behaviour לפתיחת תפריט המשנה שלו (1).

  • לחצו פעמיים על הגדרות System Settings (2) ובחרו Android SDK (3).

  • סמנו V בתיבה שליד ”Android 9.0 (Pie)“ (4) (API Level 28).

    הגדרות SDK

  • אשרו את ההודעה על ידי לחיצה על »אישור«.

    אמת רישוי SDK

  • קבלו את הסכם הרישיון (1) ולחץ על ”Next“ (2).

    קבל רישוי SDK

  • המתינו עד לסיום ההורדה וההתקנה של ה-SDK.

    חכה בזמן התקנת SDK

  • כאשר התקנת SDK תושלם, כפתור ”Finish“ יהפוך לכחול. לחצו עליו.

    סיים התקנת SDK

  • Android Studio עשוי להמליץ לעדכן את מערכת gradle. לעולם אל תעדכנו את gradle! זה יגרום לבעיות!

  • אם אתם רואים מידע בצד הימני התחתון של חלון Android Studio שהתוסף של Android Gradle מוכן לעדכון לחץ על הטקסט ”update“ (1).

    אי שידרוג Gradle

  • בתיבת הדו-שיח בחרו ”Don’t remind me again for this project“ (2).

    אי שידרוג Gradle

  • הפעילו מחדש את Android Studio לפני שתמשיכו.

יצירת APK חתום

החתימה פירושה שאתם מציינים שהאפליקציה היא יצירה שלכם בצורה דיגיטלית כמעין טביעת אצבע דיגיטלית בתוך האפליקציה עצמה. That is necessary because Android has a rule that it only accepts signed code to run for security reasons. For more information on this topic, follow this link.

  • לאחר הפעלת Android Studio, המתינו עד לסיום כל משימות הרקע.

    חכה למשימות ברקע

    • אזהרה: אם עולות שגיאות, אל תמשיכו אל השלבים הבאים. \ אם צריך, עיינו בפתרון בעיות לפיתרון תקלות נפוצות!

    טעות סנכרון של Gradle

  • לחצו על ”Build“ (1) בשורת התפריטים ובחרו ”Generate Signed Bundle / APK…“ (2).

    בנה קובץ אפליקציה

  • לחצו על ”APK“ (1) במקום ”Android App Bundle“ ולאחר מכן לחצו ”Next“ (2).

    קובץ APK במקום חבילה

  • וודאו שה-module הינו ”AndriodAPS.app“.

  • לחצו ”Create new“ (2) על מנת להתחיל יצירת ה-key store (מאגר המפתחות).

    **הערה: ** בהקשר זה מאגר המפתחות הוא לא יותר מאשר קובץ בו נשמר המידע לחתימת האפליקציה. הוא מוצפן והמידע מאובטח עם סיסמאות.

    צור מפתח מאגר

  • לחצו על צלמית התיקייה על מנת לבחור את הנתיב במחשב לשמירת מאגר המפתחות.

    צור מפתח מאגר

  • בחרו בנתיב בו מאגר המפתחות יישמר (1).

    צור מפתח מאגר

    אזהרה: אל תשמור את המפתח התיקייה בה שמור הפרויקט. אתם חייבים להשתמש בתיקייה שונה! מיקום טוב יכול להיות תיקיית הבית שלכם.

  • הקלידו שם קובץ למאגר המפתחות (2) ואשרו בלחיצה על ”OK“ (3).

  • רשמו (2) ואמתו (3) את סיסמת המאגר המפתחות שלכם. בחר נתיב מפתח מאגר

    הערה: הסיסמאות למאגר המפתחות לא חייבות להיות מתוחכמות. וודאו שתזכרו את הסיסמאות על ידי שמירתן במקום בטוח. In case you will not remember your passwords in the future, see troubleshooting for lost key store.

  • רשמו כינוי (4) למאגר המפתחות שלכם. בחרו כל כינוי שתרצו.

  • רשמו (5) ואמתו (6) את הסיסמה למפתח שלך

  • התוקף (7) הוא 25 שנה כברירת מחדל. אין חובה לשנות את ערך ברירת המחדל.

  • חייבים להכניס שם פרטי ושם משפחה (8). כל המידע הנוסף הוא לבחירה.

  • לחצו על ”OK“ (9) לסיום.

  • וודאו שסימנתם את התיבה לזכירת הסיסמאות (1). כך שלא תידרשו לרשום אותן שוב בפעם הבאה שתבנו את האפליקציה (כלומר, כאשר תבנו גרסה חדשה לעדכון של AndroidAPS).

  • לחצו על ”Next“ (2).

    זכור סיסמאות

  • בחרו את ”fullRelease“ (1) כגרסה לבנייה ולחצו על ”Finish“.

    בחר גרסת בנייה

  • Android Studio יראה ”Gradle Build running“ בתחתית המסך. משימה זו לוקחת זמן, תלוי במחשב ובמהירות חיבור האינטרנט. התאזרו בסבלנות!

    ריצת G

  • AndroidStudio יציג את ההודעה ”Generate Signed APK“ לאחר סיום בניית האפליקציה.

    ריצת Gradle

  • במקרה שהבנייה לא הסתיימה בהצלחה, פנו לפרק פיתרון בעיות.

  • לחצו על ההודעות להצגה מורחבת שלהן.

  • לחצו על הקישור ”locate“.

    מצא מיקום הבנייה

    • אם ההודעה אינה מוצגת יותר, תוכלו תמיד לפתוח את ה- ”Event log“ ולבחור אותו שם.בנייה מוצלחת - אירוע לוג

  • מנהל הקבצים במחשבכם ייפתח. נווטו אל הספריה ”full“ (1) > ”release (2).

    מיקום קובץ האפליקציה

  • ”app-full-release.apk“ (3) הינו הקובץ שאתם מחפשים!

העתיקו את האפליקציה אל הטלפון

Easiest way to transfer app-full-release.apk to your phone is via USB cable or Google Drive. Please note that transfer by mail might cause difficulties and is not the preferred way.

On your phone you have to allow installation from unknown sources. Manuals how to do this can be found on the internet (i.e. here or here).

פתרון בעיות

See separate page troubleshooting Android Studio.