נושאי Android — מעבדות קצרות לפי פערי הלימוד

אלה שיעורי העמקה לפרויקט com.example.topics. ענפי המעבדות מבוססים על Empty Views Activity עם Java,‏ XML ו־View Binding. מי שמתחילים מתבנית חדשה ילמדו להפעיל View Binding בתחילת מעבדת הפתיחה על שמירת מצב. רוב המעבדות מתחילות מבסיס master; כשהנושא הוא refactoring של מעבדה קודמת, בסיס ההשוואה מופיע בטבלה. קראו את בסיס ההשוואה לפני שמעתיקים שינויי קוד.

מבוא קצר ל־HTTP ול־JSON — בעברית ובאנגלית

Petstore: מטקסט JSON לאובייקטי Java ולטבלת בעלי חיים מתחיל ב־Swagger ומציג את טקסט ה־JSON לצד טבלה שנבנית מאובייקטי Java. זהו מסלול פתיחה עצמאי מ־Empty Views Activity בפרויקט Topic3 (com.example.topic), ולא ענף של פרויקט המעבדות. כולל GET,‏ POST, תרגול ב־Notepad++ ושמירה ל־preferences כתרגיל רשות. זמין בעברית וב־English, עם אותם קטעי קוד וקובצי תרגול.

בקשת LLM קטנה עם Firebase AI Logic

מתחילים בחלק 1 — הכנת הפרויקט: יצירה או פתיחה של פרויקט Android, תבנית ZIP עם View Binding והסבר ההסבה המשותף, פרויקט Firebase אישי במסלול Spark, קובץ ההגדרות, תוסף ותלויות Gradle ואתחול המודל. רק אחרי סנכרון ובנייה מוצלחים ממשיכים לחלק 2 — כפתור אחד ותשובה אחת, שמלמד Java,‏ future ו־callbacks ורושם את טוקן App Check בלחיצה הראשונה. גם באנגלית: 1 — Setup, 2 — Request.

איך לומדים מהקוד, לא רק מעתיקים אותו?

בכל מעבדה עברו על אותו רצף: נבאו תוצאה, קראו את זרימת הנתונים, כתבו את השינוי, ובדקו את התחזית. /** ... */ לפני מתודה היא Javadoc: היא מתארת את החוזה למי שקורא למתודה. @param אומר מה מותר למסור, @return מה נקבל, ו־@throws איזה כשל צפוי. הערת // בתוך גוף מתארת החלטת מימוש חשובה, למשל למה תוצאה ישנה נפסלת. אל תכתבו הערה שרק מתרגמת count++ למילים.

מעל @Override של onCreate בתבנית שלכם הוסיפו את התיעוד הבא כבר במעבדה הראשונה שתבצעו. השאירו אותו במעבדות המשך; אין צורך לשנות אותו רק משום שמצב המסך עבר ל־ViewModel. savedInstanceState הוא פרמטר של callback המערכת, גם כאשר המעבדה המסוימת אינה שומרת בו נתון משלה.

    /**
     * Creates the current Activity View tree and connects the screen's actions.
     *
     * @param savedInstanceState prior small UI snapshot, or null for a fresh launch
     */

במעבדות ארוכות יש “קוד משלים במלואו” בתוך <details>. זהו חלק מן השיעור, עם כל התיעוד וההערות. בקריאה ישירה של Markdown, פתחו גם את קובצי code/NN/*.md המקושרים בה; אין צורך להמתין לפרסום האתר או להעתיק מפרויקט דוגמה אחר. קובץ קיים מוצג כשינוי ממוקד, וקובץ חדש במלואו. השאירו תשתית תבנית שלא נדרשת לשינוי.

בוחרים מכשיר לפני התקנה ובדיקה

לכל ענפי המעבדות יש אותו applicationId:‏ com.example.topics. התקנת ענף אחר על אותו מכשיר מעדכנת את אותה אפליקציה; זו אינה אפליקציה נפרדת לכל מעבדה. לכן בוחרים אמולטור למעבדה ומוודאים את שמו לפני התקנה. בדיקת instrumentation מתקינה גם APK נוסף של הבדיקות, ויכולה לשנות את נתוני האפליקציה כחלק מן התרחיש.

ב־Android Studio בחרו את האמולטור ברשימת המכשירים של תצורת ההרצה. בשורת הפקודה, :app:connectedDebugAndroidTest אינו בחירה בשם של אמולטור יחיד. כשמחוברים כמה מכשירים, השתמשו במסלול המפורש הבא מתוך שורש הפרויקט. adb זמין בתיקיית platform-tools של Android SDK; פתחו טרמינל שבו התיקייה נמצאת ב־PATH. החליפו בכל פקודה את emulator-5562 במספר הסידורי שמופיע אצלכם ב־adb devices -l:

adb devices -l
.\gradlew.bat :app:assembleDebug :app:assembleDebugAndroidTest
adb -s emulator-5562 install -r app/build/outputs/apk/debug/app-debug.apk
adb -s emulator-5562 install -r app/build/outputs/apk/androidTest/debug/app-debug-androidTest.apk
adb -s emulator-5562 shell am instrument -w com.example.topics.test/androidx.test.runner.AndroidJUnitRunner

-s בוחר מכשיר, -r מבקש התקנה מעל גרסה קיימת ו־-w מחכה לסיום הבדיקות כדי להציג את התוצאה. ההתקנה אינה הבטחה לשמירת נתונים: הבדיקות עצמן עשויות לנקות אותם. כאן Gradle בונה את שני הקבצים, ו־ADB מתקין ומריץ רק על המכשיר שנבחר בכל פקודה. בחירת serial בתהליך PowerShell אחד אינה עוברת אוטומטית לתהליך חדש. לתיק הראיות שמרו גם את ה־serial, גרסת Android והפלט; שם ענף לבדו אינו אומר היכן נבדק הקוד. ראו בחירת מכשיר ב־ADB ו־הרצת instrumentation משורת הפקודה.

פתיחת הפרויקט ומעבר לענף של מעבדה

אחרי שכפול מלא (clone) של הפרויקט, פתחו את חלון Git ואת לשונית Log ב־Android Studio. תצוגת היומן מציגה את היסטוריית הפרויקט ואת הענפים השונים; ליד כל commit מופיעים הסימונים של הענפים שמצביעים עליו. לכן ייתכן שתראו הרבה שורות וחיבורים בין ענפים — זה צפוי.

כדי לעבור לענף התוצאה של מעבדה, מצאו ביומן commit שמסומן בשם הענף המבוקש, למשל codex/location-maps. לחצו עליו עם הכפתור הימני, פתחו Checkout, ובתפריט המשנה בחרו את שם הענף. בתמונה הענף נבחר דרך Checkout > codex/location-maps.

אחרי המעבר, Android Studio מסמן את ה־commit הנוכחי של הענף. בדוגמה, הסימון הירוק מופיע לצד Guard location callbacks across lifecycle changes.

כדי לצמצם את היומן לענף אחד, פתחו את מסנן Branch בסרגל העליון ובחרו codex/location-maps. הכותרת Branch: codex/location-maps מציינת שהיומן מסונן, וברשימה נשארת ההיסטוריה שמגיעה דרך הענף הזה.

כדי לחזור לתצוגת היומן המלאה, לחצו על × שליד Branch: codex/location-maps. הפעולה מבטלת את המסנן ומחזירה את כל היסטוריית הענפים לתצוגה; היא לא מעבירה אתכם לענף אחר.

למפת הכיסוי הרחבה: איפה לומדים כל נושא ב־Android. לתעדוף ההשלמות: מפת היעד והפערים.