Android Kotlin Fundamentals 01.4: Learn to help yourself

ה-codelab הזה הוא חלק מהקורס Android Kotlin Fundamentals. כדי להפיק את המרב מהקורס הזה, מומלץ לעבוד על ה-codelabs לפי הסדר. כל ה-codelab של הקורס מפורטים בדף הנחיתה של ה-codelab בנושא יסודות Kotlin ל-Android.

מבוא

ב-codelab הזה תלמדו על מקורות מידע שימושיים למפתחי Kotlin Android, כולל תבניות, תיעוד, סרטונים ואפליקציות לדוגמה.

מה שכדאי לדעת

  • תהליך העבודה הבסיסי ב-Android Studio.
  • איך משתמשים בעורך הפריסה ב-Android Studio.

מה תלמדו

  • איפה אפשר למצוא מידע ומשאבים למפתחי Kotlin ו-Android.
  • איך משנים את סמל מרכז האפליקציות באפליקציה.
  • איך מקבלים עזרה כשמפתחים אפליקציות ל-Android באמצעות Kotlin.

הפעולות שתבצעו:

  • כדאי לעיין בחלק מהמשאבים שזמינים למפתחי Kotlin Android בכל הרמות.
  • מורידים אפליקציה לדוגמה ל-Android ב-Kotlin ובוחנים אותה.
  • שינוי סמל מרכז האפליקציות של אפליקציה.

ב-codelab הזה תלמדו על תבניות, דוגמאות, תיעוד ומשאבים אחרים שזמינים למפתחי Kotlin Android.

קודם יוצרים אפליקציה פשוטה מתבנית של Android Studio ומשנים את האפליקציה. אחר כך מורידים את אפליקציית הדוגמה Android Sunflower ומתנסים בה. מחליפים את סמל ההפעלה של אפליקציית הדוגמה (חמנייה) בנכס של תמונת קליפ-ארט שזמין ב-Android Studio (סמיילי).

‫Android Studio מספק תבניות לעיצובים נפוצים ומומלצים של אפליקציות ופעילויות. התבניות המובנות חוסכות לכם זמן ועוזרות לכם לפעול לפי השיטות המומלצות לעיצוב.

כל תבנית כוללת פעילות וממשק משתמש בסיסיים. כבר השתמשתם בתבנית 'פעילות ריקה' בקורס הזה. לתבנית Basic Activity יש יותר תכונות, והיא כוללת תכונות מומלצות של אפליקציות, כמו תפריט האפשרויות שמופיע בסרגל האפליקציות במכשירים עם Android.

שלב 1: בודקים את הארכיטקטורה של פעילות בסיסית

  1. ב-Android Studio, יוצרים פרויקט.
  2. בתיבת הדו-שיח Choose your project, בוחרים בתבנית Basic Activity ולוחצים על Next.
  3. בתיבת הדו-שיח Configure your project (הגדרת הפרויקט), נותנים לאפליקציה שם. בוחרים באפשרות Kotlin כשפה, ומסמנים את התיבה Use AndroidX artifacts (שימוש בארטיפקטים של AndroidX). לוחצים על סיום.
  4. מבצעים Build לאפליקציה ומריצים אותה באמולטור או במכשיר עם Android.
  5. מזהים את החלקים המסומנים באיור ובטבלה שלמטה. מחפשים את המקבילות שלהם במסך המכשיר או האמולטור. בודקים את קוד ה-Kotlin ואת קובצי ה-XML התואמים שמתוארים בטבלה.

היכרות עם קוד המקור של Kotlin ועם קובצי ה-XML תעזור לכם להרחיב את התבנית Basic Activity ולהתאים אותה לצרכים שלכם.

ארכיטקטורה של תבנית הפעילות הבסיסית

#

תיאור ממשק המשתמש

הפניה לקוד

1

סרגל הסטטוס, שמסופק ונשלט על ידי מערכת Android.

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

2

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

ב-activity_main.xml, מחפשים את סרגל הכלים.

בתוך האלמנט AppBarLayout. כדי לשמור על תאימות לאחור, התג AppBarLayout בתבנית מטמיע תג Toolbar עם אותה פונקציונליות כמו של ActionBar.

כדי לשנות את המראה של סרגל האפליקציות, משנים את מאפייני סרגל הכלים. מדריכים בנושא סרגל האפליקציות זמינים במאמר הוספת סרגל האפליקציות.

3

שם האפליקציה נגזר בהתחלה משם החבילה, אבל אפשר לשנות אותו לכל שם שרוצים.

ב-AndroidManifest.xml, מחפשים

android:label="@string/app_name".

מציינים את המחרוזת app_name ב-strings.xml.

4

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

בMainActivity.kt,

השיטה onOptionsItemSelected() מיישמת את מה שקורה כשהמשתמש בוחר פריט בתפריט.

כדי לראות את הפריטים בתפריט האפשרויות, פותחים את res/menu/menu_main.xml

שלך. בתבנית הזו מצוינת רק האפשרות הגדרות בתפריט.

5

CoordinatorLayout ViewGroup הוא פריסה שמספקת מנגנונים לאינטראקציה בין רכיבי ממשק משתמש. ממשק המשתמש של האפליקציה נמצא בתוך הקובץ content_main.xml, שנכלל בתוך ViewGroup.

ב-activity_main.xml, מחפשים את ההוראה include layout. לא צוינו תצוגות בפריסה הזו. במקום זאת, הפריסה כוללת את הפריסה content_main, שבה צוינו התצוגות של האפליקציה. תצוגות המערכת נשמרות בנפרד מהתצוגות הייחודיות לאפליקציה.

6

התבנית משתמשת ב-TextView כדי להציג את הטקסט Hello World. מחליפים את TextView ברכיבי ממשק המשתמש של האפליקציה.

תצוגת הטקסט 'Hello World' נמצאת בקובץ content_main.xml. כל רכיבי ממשק המשתמש של האפליקציה צריכים להיות מוגדרים בקובץ הזה.

7

לחצן פעולה צף (FAB)

ב-activity_main.xml, מחפשים את הרכיב FloatingActionButton. ה-FAB מוגדר כרכיב בממשק המשתמש באמצעות סמל של קליפ-ארט. ‫MainActivity.kt כולל stub ב-onCreate() שמגדיר מאזין onClick() ל-FAB.

שלב 2: התאמה אישית של האפליקציה שנוצרת מהתבנית

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

  1. משנים את שם האפליקציה שמוצג בסרגל האפליקציות. כדי לעשות זאת, משנים את מחרוזת המשאב app_name בקובץ res > values > strings.xml למחרוזת הבאה:
<string name="app_name">New Application</string>
  1. משנים את הצבע של סרגל האפליקציה (Toolbar) ב-res > layout > activity_main.xml על ידי שינוי המאפיין android:background ל-"?attr/colorPrimaryDark". הערך הזה מגדיר את הצבע של סרגל האפליקציות לצבע ראשי כהה יותר שתואם לצבע של שורת המצב:
android:background="?attr/colorPrimaryDark"
  1. מריצים את האפליקציה. השם החדש של האפליקציה מופיע בשורת הסטטוס, וצבע הרקע של סרגל האפליקציה כהה יותר וזהה לצבע של שורת הסטטוס. כשלוחצים על הלחצן הראשי לפעולה, מופיעה הודעה קצרה (snackbar), כמו שמוצג ב-1 בצילום המסך שלמטה.
  2. משנים את הטקסט של חטיף המידע. כדי לעשות זאת, פותחים את MainActivity ומחפשים את קוד ה-stub ב-onCreate() שמגדיר מאזין onClick() ללחצן. משנים את "Replace with your own action" למשהו אחר. לדוגמה:
fab.setOnClickListener { view ->
   Snackbar.make(view, "This FAB needs an action!", Snackbar.LENGTH_LONG)
       .setAction("Action", null).show()
}
  1. הלחצן הראשי משתמש בצבע המשני של האפליקציה, ולכן דרך אחת לשנות את הצבע של הלחצן הראשי היא לשנות את הצבע המשני. כדי לשנות את הצבע המשני, פותחים את הקובץ res > values > colors.xml ומשנים את המאפיין colorAccent, כמו שמוצג בהמשך. (לקבלת עזרה בבחירת צבעים, אפשר לעיין במערכת הצבעים של Material Design).
<color name="colorAccent">#1DE9B6</color>
  1. מריצים את האפליקציה. לחצן הפעולה הצף משתמש בצבע החדש, והטקסט בהודעה הקופצת השתנה.

שלב 3: איך מוסיפים פעילויות באמצעות תבניות

עד עכשיו, השתמשתם בתבניות Empty Activity ו-Basic Activity כדי להתחיל פרויקטים חדשים ב-codelabs של הקורס הזה. אפשר גם להשתמש בתבניות של פעילויות כשיוצרים פעילויות אחרי שהפרויקט נוצר.

  1. יוצרים פרויקט אפליקציה או בוחרים פרויקט קיים.
  2. בחלונית Project > Android (פרויקט > Android), לוחצים לחיצה ימנית על התיקייה java.
  3. בוחרים באפשרות חדש > פעילות > גלריה.
  4. בוחרים אחת מActivity התבניות כדי להוסיף פעילות לאפליקציה. לדוגמה, בוחרים באפשרות Navigation Drawer Activity כדי להוסיף Activity עם מגירת ניווט.
  5. כדי להציג את הפעילות בעורך הפריסה, לוחצים לחיצה כפולה על קובץ הפריסה של הפעילות (לדוגמה, activity_main2.xml). משתמשים בכרטיסייה Design ובכרטיסייה Text כדי לעבור בין תצוגה מקדימה של פריסת הפעילות לבין קוד הפריסה.

במאגרי הדוגמאות של Google ב-GitHub יש דוגמאות קוד של Kotlin Android שאפשר ללמוד מהן, להעתיק אותן ולשלב אותן בפרויקטים שלכם.

שלב 1: הורדה והפעלה של קוד לדוגמה של Kotlin Android

  1. בדפדפן, עוברים לכתובת github.com/googlesamples.
  2. בשדה שפה, בוחרים באפשרות Kotlin.
  3. בוחרים אפליקציה לדוגמה של Kotlin Android שעברה שינוי לאחרונה ומורידים את קוד הפרויקט של האפליקציה. בדוגמה הזו, מורידים את קובץ ה-ZIP של האפליקציה android-sunflower, שכוללת הדגמה של חלק מהרכיבים של Android Jetpack.
  4. ב-Android Studio, פותחים את הפרויקט android-sunflower-master.
  5. מאשרים את כל העדכונים שמומלצים ב-Android Studio, ואז מריצים את האפליקציה באמולטור או במכשיר עם Android.

שלב 2: בודקים דוגמת קוד ל-Android ב-Kotlin

אחרי שפותחים את אפליקציית הדוגמה של חמנייה ל-Android ב-Android Studio, אפשר לקרוא על האפליקציה ולעיין בקבצי הפרויקט שלה.

  1. כדי לקבל מידע על מה שמודגם באפליקציה לדוגמה, אפשר לעיין בקובץ ה-README של האפליקציה ב-GitHub. לדוגמה הזו, אפשר לעיין בקובץ ה-README של Android Sunflower.
  2. ב-Android Studio, פותחים אחד מקובצי הפעילות של Kotlin באפליקציה, לדוגמה GardenActivity.kt.
  3. ב-GardenActivity.kt, מחפשים מחלקה, סוג או הליך שלא מכירים ומחפשים אותם בתיעוד למפתחי Android. לדוגמה, כדי לקבל מידע נוסף על השיטה setContentView(), מחפשים באתר developer.android.com את setContentView().

שלב 3: שינוי הסמל של מרכז האפליקציות

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

סמלים של מרכז האפליקציות

כל אפליקציה שיוצרים באמצעות Android Studio מתחילה עם סמל ברירת מחדל במרכז האפליקציות שמייצג את האפליקציה. לפעמים קוראים לסמלים במרכז האפליקציות סמלי אפליקציות או סמלי מוצרים.

אם מפרסמים אפליקציה ב-Google Play, סמל ההפעלה של האפליקציה מופיע בדף האפליקציה ובתוצאות החיפוש בחנות Google Play.

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

שינוי הסמל של מרכז האפליקציות

תהליך שינוי הסמל של מרכז האפליקציות מאפשר לכם להכיר את התכונות של נכסי תמונות ב-Android Studio.

ב-Android Studio, כך משנים את סמל מרכז האפליקציות של אפליקציית Sunflower ל-Android:

  1. בחלונית Project > Android, לוחצים לחיצה ימנית (או Control+click) על התיקייה res. בוחרים באפשרות חדש > נכס תמונה. מופיעה תיבת הדו-שיח Configure Image Asset (הגדרת נכס תמונה).

לוחצים על הכרטיסייה Foreground Layer (שכבת הרקע) של סמל מרכז האפליקציות.

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

  3. לוחצים על סמל הרובוט בשדה Clip Art (מאגר תמונות קליפ), שמוצג כ-2 בצילום המסך שלמעלה. מופיעה תיבת הדו-שיח Select Icon (בחירת סמל), שבה מוצגת קבוצת הסמלים של Material Design.
  4. מעיינים בתיבת הדו-שיח בחירת סמל או מחפשים סמל לפי שם. בוחרים סמל, למשל סמל המצב רוח כדי להציע מצב רוח טוב. לוחצים על אישור.

  1. בתיבת הדו-שיח הגדרת נכס תמונה, לוחצים על הכרטיסייה שכבת רקע. בקטע סוג הנכס, בוחרים באפשרות צבע. לוחצים על משבצת הצבע ובוחרים צבע לשימוש כשכבת הרקע של הסמל.
  2. לוחצים על הכרטיסייה קודם ובודקים את הגדרות ברירת המחדל. מאשרים שרוצים ליצור סמלים מדור קודם, סמלים עגולים וסמלים לחנות Google Play. לוחצים על Next.
  3. מופיעה תיבת הדו-שיח Confirm Icon Path (אישור נתיב הסמל), שבה מוצג המקום שבו קובצי הסמלים מתווספים ונכתבים מחדש. לוחצים על סיום.
  4. מריצים את האפליקציה באמולטור AVD או במכשיר עם Android.

‫Android Studio מוסיף באופן אוטומטי את תמונות הסמל של האפליקציה לספריות mipmap עבור צפיפויות המסך השונות. אפליקציית החמנייה ל-Android משתמשת עכשיו בסמל החדש של קליפ-ארט כסמל ההפעלה שלה.

  1. מריצים את האפליקציה שוב. מוודאים שהסמל החדש של מרכז האפליקציות מופיע במסך 'חיפוש אפליקציות'.

שלב 1: מעיינים במסמכי התיעוד הרשמיים של Android

כדאי לעיין בכמה מהאתרים הכי שימושיים של מסמכי התיעוד של Android כדי להכיר את המידע שזמין בהם:

  1. נכנסים לכתובת developer.android.com. Google מעדכנת את המסמכים הרשמיים למפתחים של Android.
  2. עוברים אל developer.android.com/design/‎. באתר הזה מפורטות הנחיות לעיצוב המראה והפונקציונליות של אפליקציות Android באיכות גבוהה.
  3. נכנסים לאתר material.io, שמוקדש לעיצוב חדשני תלת-ממדי. ‫Material Design היא פילוסופיית עיצוב קונספטואלית שמסבירה איך כל האפליקציות, ולא רק אפליקציות ל-Android, צריכות להיראות ולפעול במכשירים ניידים. אפשר ללחוץ על הקישורים כדי לקבל מידע נוסף על Material Design. לדוגמה, כדי לקבל מידע על השימוש בצבע, לוחצים על הכרטיסייה עיצוב ואז בוחרים באפשרות צבע.
  4. בכתובת developer.android.com/docs/ אפשר למצוא מידע על API, מסמכי עזר, מדריכים, מדריכים לכלים ודוגמאות קוד.
  5. בכתובת developer.android.com/distribute/ אפשר למצוא מידע על פרסום אפליקציה ב-Google Play. ‫Google Play היא מערכת ההפצה הדיגיטלית של Google לאפליקציות שפותחו באמצעות Android SDK. בעזרת Google Play Console אתם יכולים להגדיל את בסיס המשתמשים שלכם ולהתחיל להרוויח כסף.
  1. מומלץ לעיין בערוץ YouTube למפתחי Android, שבו אפשר למצוא הדרכות וטיפים שימושיים.
  2. בבלוג הרשמי של Android, צוות Android מפרסם חדשות וטיפים.
  3. מזינים שאלה בחיפוש Google, ומנוע החיפוש של Google אוסף תוצאות רלוונטיות ממקורות שונים. לדוגמה, אפשר להשתמש בחיפוש Google כדי לשאול את השאלה "מהי הגרסה הכי פופולרית של מערכת ההפעלה Android בהודו?". אפשר אפילו להזין הודעות שגיאה בחיפוש Google.

שלב 3: חיפוש ב-Stack Overflow

Stack Overflow היא קהילה של מתכנתים שעוזרים אחד לשני. אם נתקלתם בבעיה, סביר להניח שמישהו כבר פרסם תשובה.

  1. עוברים אל Stack Overflow.
  2. בתיבת החיפוש, מזינים שאלה כמו 'איך מגדירים ומשתמשים ב-ADB דרך Wi-Fi?' אפשר לחפש ב-Stack Overflow בלי להירשם, אבל אם רוצים לפרסם שאלה חדשה או לענות על שאלה, צריך להירשם.
  3. בתיבת החיפוש, מזינים [android]. הסוגריים המרובעים [] מציינים שרוצים לחפש פוסטים שתויגו כפוסטים בנושא Android.
  4. כדי שהחיפוש יהיה ספציפי יותר, אפשר לשלב בין תגים ומונחי חיפוש. כדאי לנסות את החיפושים הבאים:
  • [android] and [layout]
  • [android] "hello world"

שלב 4: שימוש ב-SDK Manager להתקנת תיעוד אופליין

כשמתקינים את Android Studio, רכיבים חיוניים של Android SDK מותקנים יחד איתו. כדי להתקין ספריות ומסמכים אחרים שזמינים, משתמשים ב-SDK Manager.

כדי לעיין ב-SDK Manager ולהוריד את התיעוד של ה-SDK, פועלים לפי השלבים הבאים:

  1. ב-Android Studio, בוחרים באפשרות Tools > SDK Manager. מנהל ה-SDK ייפתח.
  2. בעמודה הימנית של SDK Manager, בוחרים באפשרות Android SDK (1 בצילום המסך שלמטה).
  3. שימו לב לנתיב בשדה Android SDK Location (2 בצילום המסך שלמטה). בהמשך משתמשים בנתיב הזה כדי למצוא את מה שמתקינים.
  4. ב-SDK Manager, לוחצים על הכרטיסייה SDK Platforms (פלטפורמות SDK). מכאן אפשר להתקין גרסאות נוספות של מערכת Android.
  5. לוחצים על הכרטיסייה SDK Tools (כלים ל-SDK). מכאן אפשר להתקין כלי פיתוח ל-SDK שלא מותקנים כברירת מחדל. אפשר גם להתקין גרסה אופליין של תיעוד המפתחים של Android.
  6. לוחצים על הכרטיסייה אתרי עדכון של SDK. ‫Android Studio בודק באופן קבוע אם יש עדכונים לאתרים שמופיעים ברשימה ולאתרים שנבחרו.
  7. חוזרים לכרטיסייה SDK Tools (כלי SDK) ומסמנים את התיבה Documentation for Android SDK (תיעוד ל-Android SDK), אם היא עדיין לא מסומנת. לוחצים על החלה.

    תיבת דו-שיח לאישור תיפתח ותציג את נפח האחסון בדיסק שנדרש להורדה. לוחצים על אישור.
  8. בסיום ההתקנה, לוחצים על סיום.

כדי למצוא את התיעוד שהתקנתם:

  1. במחשב, עוברים לספרייה Android/sdk/. (כדי למצוא את הנתיב לספרייה, אפשר לעיין בשדה Android SDK Location, שמוצג כ-2 בצילום המסך שלמעלה).
  2. פותחים את הספרייה docs/.
  3. מאתרים את קובץ index.html ופותחים אותו בדפדפן.
  • התיעוד הרשמי למפתחים של Android זמין בכתובת developer.android.com.
  • Material Design היא פילוסופיית עיצוב קונספטואלית שמסבירה איך אפליקציות צריכות להיראות ולפעול במכשירים ניידים. ‫Material Design לא מיועד רק לאפליקציות ל-Android. ההנחיות של Material Design זמינות בכתובת material.io.
  • ‫Android Studio מספק תבניות לעיצובים נפוצים ומומלצים של אפליקציות ופעילויות. התבניות האלה כוללות קוד פעיל לתרחישי שימוש נפוצים.
  • כשיוצרים פרויקט, אפשר לבחור תבנית לפעילות הראשונה.
  • במהלך פיתוח האפליקציה, אפשר ליצור פעילויות ורכיבים אחרים של האפליקציה מתבניות מובנות.
  • ב-Google Samples יש דוגמאות קוד שאפשר ללמוד מהן, להעתיק אותן ולשלב אותן בפרויקטים שלכם.

קורס ב-Udacity:

מסמכי תיעוד של Android Studio:

מסמכי תיעוד למפתחי Android:

דוגמאות קוד:

סרטי וידאו:

מקורות מידע נוספים:

עוברים לשיעור הבא: 2.1: פריסה ליניארית באמצעות כלי הפריסה

קישורים ל-codelabs אחרים בקורס הזה מופיעים בדף הנחיתה של ה-codelabs בנושא יסודות Android Kotlin.