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

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

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

הערות חשובות

  • נא להשתמש ב-Android Studio Version 2020.3.1 או חדש יותר כדי לבנות את ה-apk.

  • Windows 10 32-bit systems are not supported by Android Studio 2020.3.1

מפרט מומלץ של מחשב לבניית קובץ apk

מערכת הפעלה (64 ביט בלבד) חלונות 8 ומעלה Mac OS 10.14 ומעלה כל לינוקס שתומך ב-Gnome, KDE, או Unity DE; GNU C Library 2.31 או מאוחר יותר

מעבד (64 ביט בלבד)

ארכיטקטורת מעבד x86_64; דור שני של Intel Core ומעלה, או מעבד AMD עם תמיכה ב-
Windows Hypervisor
מעבדים מבוססי ARM; דור שני של Intel Core ומעלה תמיכה ב-
Windows Hypervisor
ארכיטקטורת מעבד x86_64; דור שני של Intel Core ומעלה, או מעבד AMD עם תמיכה בווירטואליזציה של AMD (AMD-V) ו-SSSE3

RAM

8GB ומעלה

דיסק קשיח

לפחות 30GB פנויים. מומלץ SSD.

רזולוציה

לפחות 1280X800

אינטרנט

פס רחב

זכרו שגם מעבד 64 ביט (סיביות) וגם מערכת הפעלה של 64 ביט הם תנאי חובה. אם המערכת שלכם לא עומדת בתנאי זה, עליכם לשנות את החומרה או התוכנה הבעייתיים או את המערכת כולה. מומלץ מאוד להשתמש ב-SSD (Solid State Disk) במקום HDD (כונן קשיח) כי זמן בניית קובץ ה-APK של התקנת AAPS יתקצר משמעותית. זוהי המלצה ולא דרישה. עם זאת, אין מניעה להשתמש בדיסק קשיח כאשר אתם בונים קובץ apk אך לשים לב שתהליך הבנייה עשוי להימשך זמן רב, אם כי לאחר התחלתה, תוכלו להשאיר אותה פועלת ללא השגחה עד להשלמתה.


מאמר זה מחולק לשני חלקים.

  • בחלק הסקירה יש הסבר על השלבים הדרושים לבניית קובץ ה-APK.

  • בחלק המדריך צעד אחר צעד תמצאו את צילומי המסך של תהליך שלם. מכיוון שהגרסאות של Android Studio - סביבת פיתוח התוכנה בה נשתמש לבניית ה-APK - ישתנו מהר מאוד זה לא יהיה זהה להתקנה שלך אבל זה אמור לתת לך נקודת התחלה טובה. Android Studio פועל גם על Windows, Mac OS X ו-Linux וייתכנו הבדלים קטנים בהיבטים מסוימים בין כל פלטפורמה. אם אתם מגלים שמשהו חשוב שגוי או חסר, אנא הודע לקבוצת הפייסבוק ”AndroidAPS Users“ או בצ’אט Discord Android APS כדי שנוכל לבדוק זאת.

סקירה כללית

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

  1. התקנת Git

  2. התקנת Android Studio

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

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

  5. הורדת Android SDK

  6. Build the app (generate signed apk)

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

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

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

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

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

Follow the manual on the git installation page.

התקנת Android Studio

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

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

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

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

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

על תייבא הגדרות

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

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

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

מסך הכניסה

בחר בהתקנה ”Standard“ ולחץ על ”הבא“.

התקנה בסיסית

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

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

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

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

אימות הגדרות

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

רכיבי הורדות

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

Make sure git is installed on your computer and you have restarted your computer after installing.

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

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

Windows

  • As windows user, make sure you have restarted your computer after installing 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 חתום

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

  • לאחר הפעלת 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) הינו הקובץ שאתם מחפשים!

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

הדרך הקלה ביותר להעביר או להעתיק את האפליקציה לטלפון החכם היא דרך כבל USB או Google Drive. שימו לב שהעברה דרך דואר אלקטרוני יכולה לגרום לבעיות שאינה מומלצת.

בטלפון החכם שלכם עליכם לאפשר התקנה ממקורות לא ידועים. מדריכים לכך ניתן למצוא באינטרנט (כלומר כאן או כאן).

פתרון בעיות

ראו דף נפרד פיתרון בעיות של Android Studio.