אם האפליקציה שלכם יכולה לבצע פעולה שעשויה להיות שימושית לאפליקציה אחרת, הכינו אותה להגיב לבקשות פעולה על ידי ציון מסנן ה-Intent המתאים בפעילות.
לדוגמה, אם אתם מפתחים יישום חברתי שמאפשר לשתף הודעות או תמונות עם החברים של המשתמש, אתם צריכים לתמוך ב-intent ACTION_SEND.
כך, כשמשתמשים יתחילו פעולת "שיתוף" מאפליקציה אחרת, האפליקציה שלכם תופיע כאפשרות בתיבת הדו-שיח לבחירה (שנקראת גם תיבת הדו-שיח להפגת עמימות), כמו שמוצג באיור 1.
איור 1. תיבת הדו-שיח של הבורר.
כדי לאפשר לאפליקציות אחרות להתחיל את הפעילות שלכם בדרך הזו, אתם צריכים להוסיף רכיב <intent-filter> בקובץ המניפסט של רכיב <activity> התואם.
כשמתקינים את האפליקציה במכשיר, המערכת מזהה את מסנני ה-Intent ומוסיפה את המידע לקטלוג פנימי של Intent שנתמכים על ידי כל האפליקציות המותקנות.
כשאפליקציה קוראת ל-startActivity() או ל-startActivityForResult() עם כוונה משתמעת, המערכת בודקת אם יש פעילויות שיכולות להגיב לכוונה.
הוספת מסנן Intent
כדי להגדיר בצורה נכונה את ה-Intent שהפעילות יכולה לטפל בהם, צריך להגדיר כל מסנן Intent שמוסיפים בצורה ספציפית ככל האפשר מבחינת סוג הפעולה והנתונים שהפעילות מקבלת.
המערכת עשויה לשלוח Intent מסוים לפעילות אם יש לה מסנן Intent שעומד בקריטריונים הבאים של האובייקט Intent:
- פעולה
- מחרוזת שנותנת שם לפעולה שצריך לבצע. בדרך כלל אחד מהערכים שמוגדרים בפלטפורמה, כמו
ACTION_SENDאוACTION_VIEW.ציינו זאת במסנן ה-Intent באמצעות הרכיב
<action>. הערך שאתם מציינים ברכיב הזה צריך להיות שם המחרוזת המלא של הפעולה, במקום הקבוע של ה-API, כמו שמוצג בדוגמאות בדף הזה. - נתונים
- תיאור של הנתונים שמשויכים ל-Intent.
ציינו זאת במסנן ה-Intent באמצעות הרכיב
<data>. באמצעות מאפיין אחד או יותר ברכיב הזה, אתם יכולים לציין את סוג ה-MIME, קידומת URI, סכמת URI או שילוב של אלה ושל מאפיינים אחרים שמציינים את סוג הנתונים שהאפליקציה מקבלת.הערה: אם אתם לא צריכים להצהיר על פרטים ספציפיים לגבי הנתונים
Uri, למשל כשהפעילות מטפלת בסוג אחר של נתונים "נוספים", במקום URI, ציינו רק את המאפייןandroid:mimeTypeכדי להצהיר על סוג הנתונים שהפעילות מטפלת בהם, כמוtext/plainאוimage/jpeg. - קטגוריה
- מספק דרך נוספת לאפיין את הפעילות שמטפלת ב-Intent, בדרך כלל בהקשר של תנועת המשתמש או המיקום שממנו היא התחילה. המערכת תומכת בכמה קטגוריות שונות, אבל רובן לא בשימוש. עם זאת, כל ה-intent המשתמעים מוגדרים כברירת מחדל עם
CATEGORY_DEFAULT.מציינים את זה במסנן ה-Intent באמצעות הרכיב
<category>.
במסנן ה-Intent, אתם יכולים להצהיר על הקריטריונים שהפעילות שלכם מקבלת. כדי לעשות את זה, צריך להצהיר על כל אחד מהם באמצעות רכיבי XML תואמים שמוטמעים ברכיב <intent-filter>.
לדוגמה, הנה פעילות עם מסנן Intent שמטפל ב-Intent מסוג ACTION_SEND כשסוג הנתונים הוא טקסט או תמונה:
<activity android:name="ShareActivity"> <intent-filter> <action android:name="android.intent.action.SEND"/> <category android:name="android.intent.category.DEFAULT"/> <data android:mimeType="text/plain"/> <data android:mimeType="image/*"/> </intent-filter> </activity>
טיפ: אם רוצים שהסמל בתיבת הדו-שיח של הבחירה יהיה שונה מסמל ברירת המחדל של הפעילות, מוסיפים את android:icon ברכיב <intent-filter>.
כל Intent נכנס מציין רק פעולה אחת וסוג נתונים אחד, אבל אפשר להצהיר על כמה מופעים של הרכיבים <action>, <category> ו-<data> בכל <intent-filter>.
אם יש שני זוגות של פעולה ונתונים שסותרים זה את זה בהתנהגות שלהם, צריך ליצור מסנני Intent נפרדים כדי לציין אילו פעולות מקובלות כשמצמידים אותן לסוגי נתונים מסוימים.
לדוגמה, נניח שהפעילות שלכם מטפלת גם בטקסט וגם בתמונות, גם ב-Intent מסוג ACTION_SEND וגם ב-Intent מסוג ACTION_SENDTO. במקרה כזה, צריך להגדיר שני מסנני Intent נפרדים לשתי הפעולות, כי Intent מסוג ACTION_SENDTO חייב להשתמש בנתונים Uri כדי לציין את כתובת הנמען באמצעות סכמת ה-URI send או sendto. כמו בדוגמה הבאה:
<activity android:name="ShareActivity"> <!-- Filter for sending text; accepts SENDTO action with sms URI schemes --> <intent-filter> <action android:name="android.intent.action.SENDTO"/> <category android:name="android.intent.category.DEFAULT"/> <data android:scheme="sms" /> <data android:scheme="smsto" /> </intent-filter> <!-- Filter for sending text or images; accepts SEND action and text or image data --> <intent-filter> <action android:name="android.intent.action.SEND"/> <category android:name="android.intent.category.DEFAULT"/> <data android:mimeType="image/*"/> <data android:mimeType="text/plain"/> </intent-filter> </activity>
הערה: כדי לקבל כוונות משתמש משתמעות, צריך לכלול את הקטגוריה CATEGORY_DEFAULT במסנן ה-Intent. השיטות startActivity() ו-startActivityForResult() מתייחסות לכל ה-intent כאילו הן הצהירו על הקטגוריה CATEGORY_DEFAULT. אם לא תצהירו עליו במסנן ה-Intent, שום Intent משתמע לא יפעיל את הפעילות שלכם.
מידע נוסף על שליחה וקבלה של אובייקטים מסוג Intent של ACTION_SEND שמבצעים פעולות של שיתוף במדיה חברתית זמין במאמר קבלת נתונים פשוטים מאפליקציות אחרות.
מידע שימושי נוסף על שיתוף נתונים זמין במאמרים שיתוף נתונים פשוטים ושיתוף קבצים.
טיפול ב-Intent בפעילות שלכם
כדי להחליט איזו פעולה לבצע בפעילות, קוראים את Intent שמשמשת להפעלת הפעילות.
כשהפעילות מתחילה, צריך להפעיל את getIntent() כדי לאחזר את ה-Intent שהתחיל את הפעילות. אפשר לעשות את זה בכל שלב במחזור החיים של הפעילות, אבל בדרך כלל עושים את זה במהלך קריאות חוזרות מוקדמות, כמו onCreate() או onStart().
כמו בדוגמה הבאה:
Kotlin
override fun onCreate(savedInstanceState: Bundle?) { super.onCreate(savedInstanceState) setContentView(R.layout.main) val data: Uri? = intent?.data // Figure out what to do based on the intent type if (intent?.type?.startsWith("image/") == true) { // Handle intents with image data } else if (intent?.type == "text/plain") { // Handle intents with text } }
Java
@Override protected void onCreate(Bundle savedInstanceState) { super.onCreate(savedInstanceState); setContentView(R.layout.main); // Get the intent that started this activity Intent intent = getIntent(); Uri data = intent.getData(); // Figure out what to do based on the intent type if (intent.getType().indexOf("image/") != -1) { // Handle intents with image data } else if (intent.getType().equals("text/plain")) { // Handle intents with text } }
החזרת תוצאה
אם רוצים להחזיר תוצאה לפעילות שהפעילה את הפעילות שלכם, צריך להפעיל את setResult() כדי לציין את קוד התוצאה ואת התוצאה Intent. כשהפעולה מסתיימת והמשתמש חוזר לפעילות המקורית, צריך להפעיל את finish() כדי לסגור ולהשמיד את הפעילות. כמו בדוגמה הבאה:
Kotlin
// Create intent to deliver some kind of result data Intent("com.example.RESULT_ACTION", Uri.parse("content://result_uri")).also { result -> setResult(Activity.RESULT_OK, result) } finish()
Java
// Create intent to deliver some kind of result data Intent result = new Intent("com.example.RESULT_ACTION", Uri.parse("content://result_uri")); setResult(Activity.RESULT_OK, result); finish();
תמיד צריך לציין קוד תוצאה עם התוצאה. בדרך כלל, זה RESULT_OK או RESULT_CANCELED. אחר כך אפשר לספק נתונים נוספים באמצעות Intent, לפי הצורך.
הערה: כברירת מחדל, התוצאה מוגדרת כ-RESULT_CANCELED. לכן, אם המשתמש לוחץ על הכפתור "הקודם" לפני השלמת הפעולה ולפני שאתם מגדירים את התוצאה, הפעילות המקורית מקבלת את התוצאה "בוטלה".
אם אתם רק צריכים להחזיר מספר שלם שמציין אחת מכמה אפשרויות של תוצאות, אתם יכולים להגדיר את קוד התוצאה לכל ערך שגבוה מ-0. אם אתם משתמשים בקוד התוצאה כדי להעביר מספר שלם ואין לכם צורך לכלול את ה-Intent, אתם יכולים להפעיל את setResult() ולהעביר רק קוד תוצאה:
Kotlin
setResult(RESULT_COLOR_RED) finish()
Java
setResult(RESULT_COLOR_RED); finish();
במקרה כזה, יכול להיות שיהיו רק כמה תוצאות אפשריות, כך שקוד התוצאה הוא מספר שלם שמוגדר באופן מקומי (גדול מ-0). השיטה הזו פועלת היטב כשמחזירים תוצאה לפעילות באפליקציה שלכם, כי הפעילות שמקבלת את התוצאה יכולה להפנות לקבוע הציבורי כדי לקבוע את הערך של קוד התוצאה.
הערה: אין צורך לבדוק אם הפעילות התחילה באמצעות startActivity() או startActivityForResult(). פשוט קוראים ל-setResult() אם הכוונה שהפעילה את הפעילות שלכם עשויה לצפות לתוצאה. אם הפעילות המקורית קראה ל-startActivityForResult(), המערכת תעביר לה את התוצאה שסיפקתם ל-setResult(). אחרת, המערכת תתעלם מהתוצאה.