בניית קובץ ה-APK
בנייה עצמית במקום הורדה
AAPS is not available as download due to regulation for medical devices. בנייה עצמית של היישום לשימוש אישי הינה חוקית אך אסור לתת את היישום לאחרים! ראו שאלות נפוצות לפרטים.
הערות חשובות
נא להשתמש ב-Android Studio Version 2020.3.1 או חדש יותר כדי לבנות את ה-apk.
מערכות Windows 10 של 32 ביט אינן נתמכות על ידי 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 וייתכנו הבדלים קטנים בהיבטים מסוימים בין כל פלטפורמה. If you find that something important is wrong or missing, please inform the facebook group ”AAPS users“ or in the Discord chat Android APS so that we can have a look at this.
סקירה כללית
באופן כללי, השלבים של בניית קובץ ה-APK הם:
מדריך שלב אחר שלב
תיאור מפורט של השלבים הדרושים לבניית קובץ ה-APK.
התקינו git (אם לא מותקן כבר)
עקבו אחר המדריך בדף התקנת של git.
התקנת Android Studio
צילומי המסך הבאים נלקחו מגרסת Android Studio Arctic Fox | 2020.3.1. המסכים עשויים להשתנות בגרסאות עתידיות של Android Studio. אף על פי כן, אתם צפויים להיות מסוגלים למצוא את דרככם. אפשר לקבל עזרה מהקהילה.
אחד הדברים החשובים ביותר בעת התקנת Android Studio: היו סבלניים! במהלך ההתקנה וההגדרה Android Studio מוריד הרבה דברים וזה לוקח זמן.
הורידו את Android Studio מכאן והתקינו אותו במחשבכם.
בפעם הראשונה יופיע אשף ההתקנה:
בחרו ”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.
Download AAPS code
במסך הפתיחה של 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
to the main AAPS repository into the URL textbox (3).בחרו את הספרייה שבה ברצונכם לשמור את הקוד המשוכפל (4).
לחץ על כפתור ”Clone“ (5).
אל תלחצו על ”Background“ בזמן שהמאגר משוכפל!
לאחר שכפול המאגר בהצלחה, Android Studio יפתח את הפרויקט המשוכפל.
אתם תישאלו אם אתם נותנים אמון בפרויקט. בחרו ”Trust project“!
בשורת המצב בתחתית תראו את מידע על כך ש-Android Studio מפעיל משימות ברקע.
העניקו גישה אם חומת האש (Firewall) שלכם מבקשת רשות.
לאחר סיום משימות הרקע, סביר להניח שתראו שגיאה האומרת שהתרחשו שגיאות (1) או (2) או (3).
אל דאגה, תכף הן תטופלנה!
הורדת Android SDK
In the menu, go to File (1) > Settings (2) (or Android Studio > Preferences on Mac).
Double-click on Languages & Frameworks to open its submenu (1).
Select Android SDK (2).
Tick the box left of ”Android 9.0 (Pie)“ (3) (API Level 28).
אשרו את ההודעה על ידי לחיצה על »אישור«.
קבלו את הסכם הרישיון (1) ולחץ על ”Next“ (2).
המתינו עד לסיום ההורדה וההתקנה של ה-SDK.
כאשר התקנת SDK תושלם, כפתור ”Finish“ יהפוך לכחול. לחצו עליו.
Android Studio עשוי להמליץ לעדכן את מערכת gradle. לעולם אל תעדכנו את gradle! זה יגרום לבעיות!
If you see an information on the lower right side of your Android Studio window that Android Gradle Plugin is ready to update click on the text ”upgrade“ (1).
בתיבת הדו-שיח בחרו ”Don’t remind me again for this project“ (2).
הפעילו מחדש את 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, המתינו עד לסיום כל משימות הרקע.
אזהרה: אם עולות שגיאות, אל תמשיכו אל השלבים הבאים. \ אם צריך, עיינו בפתרון בעיות לפיתרון תקלות נפוצות!
לחצו על ”Build“ (1) בשורת התפריטים ובחרו ”Generate Signed Bundle / APK…“ (2).
לחצו על ”APK“ (1) במקום ”Android App Bundle“ ולאחר מכן לחצו ”Next“ (2).
Make sure that module is set to ”AndroidAPS.app“ (1).
לחצו ”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). So you don’t have to enter them again next time you build the apk (i.e. when updating to a new AAPS version).
לחצו על ”Next“ (2).
בחרו את ”fullRelease“ (1) כגרסה לבנייה ולחצו על ”Finish“.
Android Studio יראה ”Gradle Build running“ בתחתית המסך. משימה זו לוקחת זמן, תלוי במחשב ובמהירות חיבור האינטרנט. התאזרו בסבלנות!
AndroidStudio יציג את ההודעה ”Generate Signed APK“ לאחר סיום בניית האפליקציה.
במקרה שהבנייה לא הסתיימה בהצלחה, פנו לפרק פיתרון בעיות.
לחצו על ההודעות להצגה מורחבת שלהן.
לחצו על הקישור ”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.