אחת מהתכונות הכי חשובות של Android היא היכולת של אפליקציה להפנות את המשתמש לאפליקציה אחרת על סמך "פעולה" שהיא רוצה לבצע. לדוגמה, אם באפליקציה יש כתובת של עסק שאתם רוצים להציג במפה, אתם לא צריכים ליצור באפליקציה פעילות שמציגה מפה. במקום זאת, אתם יכולים ליצור בקשה להצגת הכתובת באמצעות Intent. מערכת Android מפעילה אפליקציה שיכולה להציג את הכתובת במפה.
כפי שהוסבר בשיעור הראשון, בניית האפליקציה הראשונה, צריך להשתמש ב-Intent כדי לנווט בין פעילויות באפליקציה. בדרך כלל עושים זאת באמצעות Intent מפורש, שמגדיר את שם המחלקה המדויק של הרכיב שרוצים להפעיל. עם זאת, אם רוצים שאפליקציה נפרדת תבצע פעולה, כמו "הצגת מפה", צריך להשתמש בIntent משתמע.
בשיעור הזה נסביר איך ליצור כוונה משתמעת לפעולה מסוימת, ואיך להשתמש בה כדי להתחיל פעילות שמבצעת את הפעולה באפליקציה אחרת. כדאי גם לצפות בסרטון שמוטמע כאן כדי להבין למה חשוב לכלול בדיקות בזמן ריצה של הכוונות המשתמעות.
יצירת Intent מרומז
ב-intent מרומז לא מצהירים על שם המחלקה של הרכיב שרוצים להפעיל, אלא על הפעולה שרוצים לבצע. הפעולה מציינת את מה שאתם רוצים לעשות, כמו הצגה, עריכה, שליחה או קבלת משהו.
שיוך פעולות Intent לנתונים
בדרך כלל, Intent כולל גם נתונים שמשויכים לפעולה, כמו הכתובת שרוצים להציג או הודעת האימייל שרוצים לשלוח.
בהתאם ל-intent שרוצים ליצור, הנתונים יכולים להיות Uri, אחד מכמה סוגי נתונים אחרים, או שה-intent לא צריך נתונים בכלל.
אם הנתונים הם Uri, יש בנאי Intent() פשוט שאפשר להשתמש בו כדי להגדיר את הפעולה ואת הנתונים.
לדוגמה, כך יוצרים Intent כדי להתחיל שיחת טלפון באמצעות נתוני Uri כדי לציין את מספר הטלפון:
Kotlin
val callIntent: Intent = Uri.parse("tel:5551234").let { number -> Intent(Intent.ACTION_DIAL, number) }
Java
Uri number = Uri.parse("tel:5551234"); Intent callIntent = new Intent(Intent.ACTION_DIAL, number);
כשהאפליקציה מפעילה את ה-Intent הזה באמצעות קריאה ל-startActivity(), אפליקציית "טלפון" מתחילה שיחה למספר הטלפון שצוין.
הנה עוד כמה כוונות וצמדי הפעולות והנתונים של Uri:
הצגת מפה
Kotlin
// Map point based on address val mapIntent: Intent = Uri.parse( "geo:0,0?q=1600+Amphitheatre+Parkway,+Mountain+View,+California" ).let { location -> // Or map point based on latitude/longitude // val location: Uri = Uri.parse("geo:37.422219,-122.08364?z=14") // z param is zoom level Intent(Intent.ACTION_VIEW, location) }
Java
// Map point based on address Uri location = Uri.parse("geo:0,0?q=1600+Amphitheatre+Parkway,+Mountain+View,+California"); // Or map point based on latitude/longitude // Uri location = Uri.parse("geo:37.422219,-122.08364?z=14"); // z param is zoom level Intent mapIntent = new Intent(Intent.ACTION_VIEW, location);
צפייה בדף אינטרנט
Kotlin
val webIntent: Intent = Uri.parse("https://www.android.com").let { webpage -> Intent(Intent.ACTION_VIEW, webpage) }
Java
Uri webpage = Uri.parse("https://www.android.com"); Intent webIntent = new Intent(Intent.ACTION_VIEW, webpage);
הוספת תוספות ל-Intent
סוגים אחרים של כוונות משתמעות דורשים נתונים "נוספים" שמספקים סוגי נתונים שונים, כמו מחרוזת. אפשר להוסיף פריט אחד או יותר של נתונים נוספים באמצעות השיטות השונות של putExtra().
כברירת מחדל, המערכת קובעת את סוג ה-MIME המתאים שנדרש על ידי Intent על סמך נתוני ה-Uri שנכללים. אם לא כוללים Uri ב-intent, בדרך כלל צריך להשתמש ב-setType() כדי לציין את סוג הנתונים שמשויכים ל-intent. הגדרת סוג ה-MIME מציינת אילו סוגי פעילויות צריכים לקבל את ה-Intent.
הנה עוד כמה כוונות שמוסיפות נתונים כדי לציין את הפעולה הרצויה:
שליחת אימייל עם קובץ מצורף
Kotlin
Intent(Intent.ACTION_SEND).apply { // The intent does not have a URI, so declare the "text/plain" MIME type type = "text/plain" putExtra(Intent.EXTRA_EMAIL, arrayOf("jan@example.com")) // recipients putExtra(Intent.EXTRA_SUBJECT, "Email subject") putExtra(Intent.EXTRA_TEXT, "Email message text") putExtra(Intent.EXTRA_STREAM, Uri.parse("content://path/to/email/attachment")) // You can also attach multiple items by passing an ArrayList of Uris }
Java
Intent emailIntent = new Intent(Intent.ACTION_SEND); // The intent does not have a URI, so declare the "text/plain" MIME type emailIntent.setType(HTTP.PLAIN_TEXT_TYPE); emailIntent.putExtra(Intent.EXTRA_EMAIL, new String[] {"jan@example.com"}); // recipients emailIntent.putExtra(Intent.EXTRA_SUBJECT, "Email subject"); emailIntent.putExtra(Intent.EXTRA_TEXT, "Email message text"); emailIntent.putExtra(Intent.EXTRA_STREAM, Uri.parse("content://path/to/email/attachment")); // You can also attach multiple items by passing an ArrayList of Uris
יצירת אירוע ביומן
הערה: ה-intent הזה לאירוע ביומן נתמך רק ב-API ברמה 14 ומעלה.
Kotlin
// Event is on January 23, 2021 -- from 7:30 AM to 10:30 AM. Intent(Intent.ACTION_INSERT, Events.CONTENT_URI).apply { val beginTime: Calendar = Calendar.getInstance().apply { set(2021, 0, 23, 7, 30) } val endTime = Calendar.getInstance().apply { set(2021, 0, 23, 10, 30) } putExtra(CalendarContract.EXTRA_EVENT_BEGIN_TIME, beginTime.timeInMillis) putExtra(CalendarContract.EXTRA_EVENT_END_TIME, endTime.timeInMillis) putExtra(Events.TITLE, "Ninja class") putExtra(Events.EVENT_LOCATION, "Secret dojo") }
Java
// Event is on January 23, 2021 -- from 7:30 AM to 10:30 AM. Intent calendarIntent = new Intent(Intent.ACTION_INSERT, Events.CONTENT_URI); Calendar beginTime = Calendar.getInstance(); beginTime.set(2021, 0, 23, 7, 30); Calendar endTime = Calendar.getInstance(); endTime.set(2021, 0, 23, 10, 30); calendarIntent.putExtra(CalendarContract.EXTRA_EVENT_BEGIN_TIME, beginTime.getTimeInMillis()); calendarIntent.putExtra(CalendarContract.EXTRA_EVENT_END_TIME, endTime.getTimeInMillis()); calendarIntent.putExtra(Events.TITLE, "Ninja class"); calendarIntent.putExtra(Events.EVENT_LOCATION, "Secret dojo");
הערה: חשוב להגדיר את Intent בצורה הכי ספציפית שאפשר. לדוגמה, אם רוצים להציג תמונה באמצעות ה-intent ACTION_VIEW, צריך לציין את סוג ה-MIME image/*. כך אפליקציות שיכולות "להציג" סוגים אחרים של נתונים (כמו אפליקציית מפות) לא יופעלו על ידי ה-Intent.
התחלת פעילות עם ה-intent
אחרי שיוצרים את Intent ומגדירים את המידע הנוסף, מפעילים את startActivity() כדי לשלוח אותו למערכת:
Kotlin
startActivity(intent)
Java
startActivity(intent);
טיפול במצב שבו אף אפליקציה לא יכולה לקבל Intent
למרות ש-intent-ים רבים מטופלים בהצלחה על ידי אפליקציה אחרת שמותקנת במכשיר – כמו אפליקציית טלפון, אימייל או יומן – האפליקציה שלכם צריכה להיות מוכנה למצב שבו אף פעילות לא יכולה לטפל ב-intent של האפליקציה. בכל פעם שאתם מפעילים Intent, אתם צריכים להיות מוכנים לתפוס ActivityNotFoundException, שמתרחש אם אין פעילות אחרת שיכולה לטפל ב-Intent של האפליקציה:
Kotlin
try { startActivity(intent) } catch (e: ActivityNotFoundException) { // Define what your app should do if no activity can handle the intent. }
Java
try { startActivity(intent); } catch (ActivityNotFoundException e) { // Define what your app should do if no activity can handle the intent. }
אחרי שתופסים את החריגה הזו, מחליטים מה האפליקציה צריכה לעשות בהמשך. השלב הבא תלוי במאפיינים הספציפיים של ה-Intent שניסיתם להפעיל. לדוגמה, אם אתם מכירים אפליקציה ספציפית שיכולה לטפל ב-Intent, אתם יכולים לספק למשתמש קישור להורדת האפליקציה. מידע נוסף על קישור למוצר שלכם ב-Google Play
תיבת דו-שיח להפגת עמימות
אם המערכת מזהה יותר מפעילות אחת שיכולה לטפל ב-Intent, היא מציגה תיבת דו-שיח (שנקראת לפעמים "תיבת דו-שיח להפגת עמימות") שבה המשתמש יכול לבחור באיזו אפליקציה להשתמש, כמו שמוצג באיור 1. אם יש רק פעילות אחת שמטפלת בכוונת המשתמש, המערכת מפעילה אותה באופן מיידי.
איור 1. דוגמה לתיבת הדו-שיח לבחירה שמופיעה כשיותר מאפליקציה אחת יכולה לטפל ב-Intent.
דוגמה פתורה
הנה דוגמה מלאה שמראה איך ליצור Intent להצגת מפה, לוודא שקיימת אפליקציה לטיפול ב-Intent, ואז להפעיל אותה:
Kotlin
// Build the intent. val location = Uri.parse("geo:0,0?q=1600+Amphitheatre+Parkway,+Mountain+View,+California") val mapIntent = Intent(Intent.ACTION_VIEW, location) // Try to invoke the intent. try { startActivity(mapIntent) } catch (e: ActivityNotFoundException) { // Define what your app should do if no activity can handle the intent. }
Java
// Build the intent. Uri location = Uri.parse("geo:0,0?q=1600+Amphitheatre+Parkway,+Mountain+View,+California"); Intent mapIntent = new Intent(Intent.ACTION_VIEW, location); // Try to invoke the intent. try { startActivity(mapIntent); } catch (ActivityNotFoundException e) { // Define what your app should do if no activity can handle the intent. }
הצגת כלי לבחירת אפליקציות
איור 2. תיבת דו-שיח לבחירה.
שימו לב שכאשר אתם מתחילים פעילות על ידי העברת ה-Intent אל startActivity() ויש יותר מאפליקציה אחת שמגיבה ל-intent, המשתמש יכול לבחור באיזו אפליקציה להשתמש כברירת מחדל (על ידי סימון תיבת סימון בתחתית תיבת הדו-שיח; ראו איור 1). זה שימושי כשמבצעים פעולה שבדרך כלל המשתמש רוצה להשתמש באותה אפליקציה בכל פעם, למשל כשפותחים דף אינטרנט (סביר להניח שהמשתמשים משתמשים רק בדפדפן אינטרנט אחד) או כשמצלמים תמונה (סביר להניח שהמשתמשים מעדיפים מצלמה אחת).
עם זאת, אם הפעולה שצריך לבצע יכולה להתבצע על ידי כמה אפליקציות, והמשתמש עשוי להעדיף אפליקציה אחרת בכל פעם – כמו פעולת "שיתוף", שבה למשתמשים יכולות להיות כמה אפליקציות שדרכן הם יכולים לשתף פריט – צריך להציג באופן מפורש תיבת דו-שיח לבחירה, כמו שמוצג באיור 2. תיבת הדו-שיח לבחירה מאלצת את המשתמש לבחור בכל פעם באיזו אפליקציה להשתמש לפעולה (המשתמש לא יכול לבחור אפליקציית ברירת מחדל לפעולה).
כדי להציג את הבורר, יוצרים Intent באמצעות createChooser() ומעבירים אותו אל startActivity(). לדוגמה:
Kotlin
val intent = Intent(Intent.ACTION_SEND) // Create intent to show chooser val chooser = Intent.createChooser(intent, /* title */ null) // Try to invoke the intent. try { startActivity(chooser) } catch (e: ActivityNotFoundException) { // Define what your app should do if no activity can handle the intent. }
Java
Intent intent = new Intent(Intent.ACTION_SEND); // Create intent to show chooser Intent chooser = Intent.createChooser(intent, /* title */ null); // Try to invoke the intent. try { startActivity(chooser); } catch (ActivityNotFoundException e) { // Define what your app should do if no activity can handle the intent. }
כך מוצגת תיבת דו-שיח עם רשימה של אפליקציות שמגיבות ל-intent שמועבר ל-method
createChooser(). אפשר לספק את הפרמטר title אם הפעולה היא לא
ACTION_SEND או
ACTION_SEND_MULTIPLE