تکالیف و پشته قبلی‌ها

تکلیف مجموعه‌ای از فعالیت‌ها است که کاربران هنگام تلاش برای انجام کاری در برنامه شما با آن‌ها تعامل می‌کنند. این فعالیت‌ها در پشته‌ای به‌نام پشته قبلی‌ها به‌ترتیب باز شدن هر فعالیت چیده شده‌اند.

برای مثال، یک برنامه ایمیل ممکن است یک فعالیت برای نمایش فهرست پیام‌های جدید داشته باشد. وقتی کاربر پیامی را انتخاب می‌کند، فعالیت جدیدی برای مشاهده آن پیام باز می‌شود. این فعالیت جدید به پشته قبلی‌ها اضافه می‌شود. سپس، وقتی کاربر روی «برگشت» تک‌ضرب می‌زند یا اشاره می‌کند، آن فعالیت جدید تمام می‌شود و از پشته خارج می‌شود.

چرخه حیات تکلیف و پشته قبلی‌های آن

صفحه اصلی دستگاه نقطه شروع اکثر کارها است. وقتی کاربر روی نماد برنامه یا میان‌بر در راه‌انداز برنامه یا صفحه اصلی تک‌ضرب می‌زند، تکلیف آن برنامه به پیش‌زمینه می‌آید. اگر هیچ تکلیفی برای برنامه وجود نداشته باشد، تکلیف جدیدی ایجاد می‌شود و فعالیت اصلی برای آن برنامه به‌عنوان فعالیت ریشه در پشته باز می‌شود.

وقتی فعالیت فعلی فعالیت دیگری را شروع می‌کند، فعالیت جدید به بالای پشته منتقل می‌شود و تمرکز را به‌دست می‌گیرد. فعالیت قبلی در پشته باقی می‌ماند، اما متوقف می‌شود. وقتی فعالیتی متوقف می‌شود، سیستم وضعیت فعلی میانای کاربر آن را حفظ می‌کند. وقتی کاربر کنش برگشت را انجام می‌دهد، فعالیت فعلی از بالای پشته برداشته می‌شود و ازبین می‌رود. فعالیت قبلی ازسر گرفته می‌شود و وضعیت قبلی میانای کاربر آن بازیابی می‌شود.

فعالیت‌های موجود در پشته هرگز بازآرایی نمی‌شوند، فقط هنگام شروع شدن اضافه می‌شوند و هنگام رد شدن با دکمه یا اشاره «برگشت» حذف می‌شوند. بنابراین، پشته قبلی‌ها به‌صورت ساختار آخرین ورودی، اولین خروجی عمل می‌کند، همان‌طور که در شکل ۱ نشان داده شده است.

شکل ۱. نمایشی از اینکه چگونه هر فعالیت جدید در یک تکلیف، موردی را به پشته قبلی‌ها اضافه می‌کند. وقتی کاربر روی «برگشت» تک‌ضرب می‌زند یا اشاره می‌کند، فعالیت فعلی ازبین می‌رود و فعالیت قبلی ازسر گرفته می‌شود.

As the user continues to tap or gesture Back, each activity in the stack is popped off to reveal the previous one, until the user returns to the Home screen or to whichever activity was running when the task began. وقتی همه فعالیت‌ها از دسته برداشته شوند، تکلیف دیگر وجود ندارد.

رفتار تک‌ضرب از پشت برای فعالیت‌های راه‌انداز ریشه

فعالیت‌های راه‌انداز ریشه فعالیت‌هایی هستند که فیلتر قصد را با ACTION_MAIN و CATEGORY_LAUNCHER اعلام می‌کنند. این فعالیت‌ها منحصربه‌فرد هستند زیرا به‌عنوان نقاط ورودی به برنامه شما ازراه‌انداز برنامه عمل می‌کنند و برای شروع تکلیف استفاده می‌شوند.

وقتی کاربر روی فعالیت راه‌انداز ریشه تک‌ضرب می‌زند یا اشاره «برگشت» را انجام می‌دهد، سیستم رویداد را بسته به نسخه Android که در دستگاه اجرا می‌شود به‌طور متفاوتی مدیریت می‌کند.

رفتار سیستم در Android 11 و نسخه‌های پایین‌تر
سیستم فعالیت را به‌پایان می‌رساند.
رفتار سیستم در Android 12 و بالاتر

سیستم به‌جای تمام کردن فعالیت، آن فعالیت و تکلیفش را به پس‌زمینه منتقل می‌کند. این رفتار با رفتار پیش‌فرض سیستم هنگام خروج از برنامه بااستفاده از دکمه یا اشاره «صفحه اصلی» مطابقت دارد.

در بیشتر موارد، این رفتار به این معنی است که کاربران می‌توانند برنامه شما را سریع‌تر از وضعیت گرم ازسر بگیرند، به‌جای اینکه مجبور باشند برنامه را کاملاً از وضعیت سرد بازراه‌اندازی کنند.

اگر لازم است پیمایش به عقب سفارشی ارائه دهید، توصیه می‌کنیم به‌جای لغو کردن onBackPressed()، از AndroidX Activity APIs استفاده کنید. اگر مؤلفه‌ای وجود نداشته باشد که تک‌ضرب سیستم روی «برگشت» را رهگیری کند، میاناهای برنامه‌سازی کاربردی AndroidX Activity به‌طور خودکار به رفتار مناسب سیستم موکول می‌شوند.

بااین‌حال، اگر برنامه‌تان onBackPressed() را لغو می‌کند تا پیمایش «برگشت» را مدیریت کند و فعالیت را به‌پایان برساند، پیاده‌سازی‌تان را به‌روز کنید تا به‌جای به‌پایان رساندن، super.onBackPressed() را فراخوانی کند. فراخوانی super.onBackPressed() فعالیت و تکلیف آن را درصورت لزوم به پس‌زمینه منتقل می‌کند و تجربه پیمایش یکپارچه‌تری را برای کاربران در سراسر برنامه‌ها فراهم می‌کند.

تکالیف پس‌زمینه و پیش‌زمینه

شکل ۲. دو تکلیف: تکلیف ب تعامل کاربر را در پیش‌زمینه دریافت می‌کند، درحالی‌که تکلیف الف در پس‌زمینه است و منتظر ازسرگیری است.

تکلیف واحدی منسجم است که وقتی کاربر تکلیف جدیدی را شروع می‌کند یا به صفحه اصلی می‌رود، می‌تواند به پس‌زمینه منتقل شود. وقتی تکلیف در پس‌زمینه است، همه فعالیت‌های آن متوقف می‌شود، اما پشته قبلی‌ها برای تکلیف دست‌نخورده باقی می‌ماند—تکلیف تمرکز را ازدست می‌دهد درحالی‌که تکلیف دیگری جای آن را می‌گیرد، همان‌طور که در شکل ۲ نشان داده شده است. سپس تکلیف می‌تواند به پیش‌زمینه برگردد تا کاربران بتوانند از جایی که متوقف شده بودند ادامه دهند.

جریان تکلیف زیر را برای «تکلیف الف» فعلی درنظر بگیرید که سه فعالیت در پشته خود دارد، ازجمله دو فعالیت در زیر فعالیت فعلی:

  1. کاربر از دکمه یا اشاره «صفحه اصلی» استفاده می‌کند، سپس برنامه جدیدی را از راه‌انداز برنامه شروع می‌کند.

    وقتی «صفحه اصلی» ظاهر می‌شود، «تکلیف الف» به پس‌زمینه می‌رود. وقتی برنامه جدید شروع می‌شود، سیستم تکلیفی را برای آن برنامه (تکلیف ب) با پشته فعالیت‌های خودش شروع می‌کند.

  2. پس‌از تعامل با آن برنامه، کاربر دوباره به «صفحه اصلی» برمی‌گردد و برنامه‌ای را که در ابتدا «تکلیف الف» را شروع کرده بود انتخاب می‌کند.

    اکنون، «تکلیف الف» به پیش‌زمینه می‌آید—هر سه فعالیت در پشته آن دست‌نخورده هستند و فعالیت بالای پشته ازسر گرفته می‌شود. در این مرحله، کاربر می‌تواند با رفتن به «صفحه اصلی» و انتخاب نماد برنامه که آن تکلیف را شروع کرده است یا با انتخاب تکلیف برنامه از صفحه موارد اخیر، دوباره به «تکلیف ب» برگردد.

چندین نمونه فعالیت

شکل ۳.‏ یک فعالیت می‌تواند چندین بار نمونه‌سازی شود.

چون فعالیت‌های موجود در پشته قبلی‌ها هرگز بازآرایی نمی‌شوند، اگر برنامه‌تان به کاربران اجازه دهد فعالیت خاصی را از بیش‌از یک فعالیت شروع کنند، نمونه جدیدی از آن فعالیت ایجاد می‌شود و به‌جای اینکه نمونه قبلی آن فعالیت به بالا آورده شود، نمونه جدید به پشته اضافه می‌شود. به این ترتیب، یک فعالیت در برنامه شما ممکن است چندین بار نمونه‌سازی شود، حتی از تکالیف مختلف، همان‌طور که در شکل ۳ نشان داده شده است.

اگر کاربر بااستفاده از دکمه یا اشاره «برگشتن» به عقب پیمایش کند، نمونه‌های فعالیت به‌ترتیبی که باز شده‌اند نشان داده می‌شوند و هرکدام وضعیت میانای کاربر خود را دارند. بااین‌حال، اگر نمی‌خواهید فعالیتی بیش‌از یک‌بار نمونه‌سازی شود، می‌توانید این رفتار را تغییر دهید. برای اطلاعات بیشتر، به مدیریت تکالیف مراجعه کنید.

محیط‌های چندپنجره‌ای

وقتی برنامه‌ها به‌طور هم‌زمان در محیط چندپنجره‌ای اجرا می‌شوند، که در Android نسخه ۷.۰ (سطح API‏ ۲۴) و بالاتر پشتیبانی می‌شود، سیستم تکالیف را به‌طور جداگانه برای هر پنجره مدیریت می‌کند. هر پنجره می‌تواند چندین تکلیف داشته باشد. این موضوع برای برنامه‌های Android که در Chromebook اجرا می‌شوند نیز صادق است: سیستم تکالیف یا گروه‌های تکالیف را براساس هر پنجره مدیریت می‌کند.

خلاصه چرخه حیات

برای خلاصه کردن رفتار پیش‌فرض برای فعالیت‌ها و تکالیف:

  • وقتی «فعالیت الف» «فعالیت ب» را شروع می‌کند، «فعالیت الف» متوقف می‌شود اما سیستم وضعیت آن را حفظ می‌کند، مثلاً موقعیت پیمایش آن و هر نوشتاری که در فرم‌ها وارد شده است. اگر کاربر در «فعالیت ب» روی اشاره «برگشت» تک‌ضرب بزند یا از آن استفاده کند، «فعالیت الف» با وضعیت بازیابی‌شده‌اش ازسر گرفته می‌شود.

  • وقتی کاربر بااستفاده از دکمه یا اشاره «صفحه اصلی» از تکلیفی خارج می‌شود، فعالیت فعلی متوقف می‌شود و تکلیف آن به پس‌زمینه می‌رود. سیستم وضعیت هر فعالیت را در تکلیف حفظ می‌کند. اگر کاربر بعداً با انتخاب نماد راه‌اندازی که تکلیف را شروع کرده است، تکلیف را ازسر بگیرد، تکلیف به پیش‌زمینه می‌آید و فعالیت را در بالای پشته ازسر می‌گیرد.

  • اگر کاربر روی «برگشت» تک‌ضرب بزند یا اشاره کند، فعالیت فعلی از پشته خارج می‌شود و ازبین می‌رود. فعالیت قبلی در پشته ازسر گرفته می‌شود. وقتی فعالیتی ازبین می‌رود، سیستم وضعیت فعالیت را حفظ نمی‌کند.

    این رفتار برای فعالیت‌های راه‌انداز ریشه در Android 12 (سطح میانای برنامه‌سازی کاربردی ۳۱) و بالاتر متفاوت است.

  • فعالیت‌ها را می‌توان چندین بار نمونه‌سازی کرد، حتی از تکالیف دیگر.

مدیریت کردن تکالیف

Android تکالیف و پشته قبلی‌ها را با قرار دادن همه فعالیت‌های شروع‌شده به‌طور متوالی در یک تکلیف، در پشته‌ای که آخرین ورودی اولین خروجی است، مدیریت می‌کند. این روش برای اکثر برنامه‌ها عالی است و معمولاً لازم نیست نگران نحوه مرتبط شدن فعالیت‌هایتان با تکالیف یا نحوه وجود آن‌ها در پشته قبلی‌ها باشید.

بااین‌حال، ممکن است تصمیم بگیرید که می‌خواهید رفتار عادی را قطع کنید. برای مثال، ممکن است بخواهید فعالیتی در برنامه‌تان هنگام شروع، تکلیف جدیدی را آغاز کند، به‌جای اینکه در تکلیف فعلی قرار گیرد. یا وقتی فعالیتی را شروع می‌کنید، ممکن است بخواهید نمونه موجودی از آن را جلو بیاورید، به‌جای اینکه نمونه جدیدی در بالای پشته قبلی‌ها ایجاد کنید. یا شاید بخواهید وقتی کاربر تکلیف را ترک می‌کند، پشته قبلی‌ها از همه فعالیت‌ها به‌جز فعالیت ریشه پاک شود.

می‌توانید این کارها و موارد دیگر را بااستفاده از مشخصه‌ها در عنصر مانیفست <activity> و پرچم‌ها در قصدی که به startActivity() ارسال می‌کنید انجام دهید.

این‌ها مشخصه‌های اصلی <activity> هستند که می‌توانید برای مدیریت تکالیف استفاده کنید:

و این‌ها پرچم‌های قصد اصلی هستند که می‌توانید استفاده کنید:

بخش‌های زیر نحوه استفاده از این مشخصه‌های مانیفست و پرچم‌های هدف را برای تعریف نحوه ارتباط فعالیت‌ها با تکالیف و نحوه رفتار آن‌ها در پشته قبلی‌ها توضیح می‌دهند.

بخش‌های زیر همچنین درباره نحوه نمایش و مدیریت تکالیف و فعالیت‌ها توسط سیستم در صفحه موارد اخیر بحث می‌کنند. Normally, you let the system define how your task and activities are represented in the recents screen, and you don't need to modify this behavior. برای کسب اطلاعات بیشتر، به صفحه موارد اخیر بروید.

تعریف حالت‌های راه‌اندازی

حالت‌های راه‌اندازی به شما امکان می‌دهد نحوه مرتبط شدن نمونه جدیدی از فعالیت با تکلیف فعلی را تعریف کنید. می‌توانید حالت‌های راه‌اندازی را به دو روش تعریف کنید که در بخش‌های زیر شرح داده شده است:

  • استفاده از فایل مانیفست

    وقتی فعالیتی را در فایل مانیفست خود اعلام می‌کنید، می‌توانید مشخص کنید که فعالیت هنگام شروع چگونه با تکالیف مرتبط می‌شود.

  • استفاده از پرچم‌های هدف

    وقتی startActivity() را فراخوانی می‌کنید، می‌توانید پرچمی را در Intent اضافه کنید که نحوه (یا اینکه آیا) فعالیت جدید با تکلیف فعلی مرتبط است یا نه را اعلام می‌کند.

بنابراین، اگر «فعالیت الف» «فعالیت ب» را شروع کند، «فعالیت ب» می‌تواند در مانیفست خود تعریف کند که چگونه با تکلیف فعلی مرتبط می‌شود، و «فعالیت الف» می‌تواند از پرچم هدف استفاده کند تا درخواست کند که چگونه «فعالیت ب» می‌تواند با تکلیف فعلی مرتبط شود.

اگر هر دو فعالیت نحوه ارتباط «فعالیت ب» با تکلیف را تعریف کنند، درخواست «فعالیت الف» که در هدف تعریف شده است بر درخواست «فعالیت ب» که در مانیفست آن تعریف شده است اولویت دارد.

تعریف کردن حالت‌های راه‌اندازی بااستفاده از فایل مانیفست

هنگام اعلام فعالیت در فایل مانیفست، می‌توانید بااستفاده از شاخصه launchMode عنصر <activity> مشخص کنید که فعالیت چگونه با تکلیف مرتبط می‌شود.

پنج حالت راه‌اندازی وجود دارد که می‌توانید به مشخصه launchMode اختصاص دهید:

  1. "standard"
    حالت پیش‌فرض. سیستم نمونه جدیدی از فعالیت را در تکلیفی که از آن شروع شده است ایجاد می‌کند و قصد را به آن هدایت می‌کند. فعالیت می‌تواند چندین‌بار نمونه‌سازی شود، هر نمونه می‌تواند به تکالیف مختلفی تعلق داشته باشد، و یک تکلیف می‌تواند چندین نمونه داشته باشد.
  2. "singleTop"
    اگر نمونه‌ای از فعالیت ازقبل در بالای تکلیف فعلی وجود داشته باشد، سیستم قصد را ازطریق تماس با روش onNewIntent() آن به آن نمونه هدایت می‌کند، به‌جای اینکه نمونه جدیدی از فعالیت ایجاد کند. فعالیت چندین‌بار نمونه‌سازی می‌شود، هر نمونه می‌تواند به تکالیف مختلفی تعلق داشته باشد، و یک تکلیف می‌تواند چندین نمونه داشته باشد (اما فقط درصورتی‌که فعالیت در بالای پشته قبلی‌ها نمونه موجودی از فعالیت نباشد).

    برای مثال، فرض کنید پشته قبلی‌های یک تکلیف شامل فعالیت ریشه A با فعالیت‌های B،‏ C، و D در بالا باشد (بنابراین پشته A-B-C-D است و D در بالا قرار دارد). یک intent برای فعالیتی از نوع D می‌رسد. اگر D حالت راه‌اندازی پیش‌فرض "standard" را داشته باشد، نمونه جدیدی از کلاس راه‌اندازی می‌شود و پشته به A-B-C-D-D تبدیل می‌شود. اما اگر حالت راه‌اندازی D‏ "singleTop" باشد، نمونه موجود D قصد را ازطریق onNewIntent() دریافت می‌کند، زیرا در بالای پشته قرار دارد و پشته به‌صورت A-B-C-D باقی می‌ماند. ازسوی‌دیگر، اگر قصدی برای فعالیتی از نوع B برسد، نمونه جدیدی از B به پشته اضافه می‌شود، حتی اگر حالت راه‌اندازی آن "singleTop" باشد.

  3. "singleTask"
    سیستم فعالیت را در ریشه تکلیف جدیدی ایجاد می‌کند یا فعالیت را در تکلیف موجودی با همان وابستگی قرار می‌دهد. اگر نمونه‌ای از فعالیت ازقبل وجود داشته باشد، سیستم به‌جای ایجاد نمونه جدید، قصد را ازطریق فراخوانی روش onNewIntent() به نمونه موجود هدایت می‌کند. در همین حال، همه فعالیت‌های دیگر روی آن ازبین می‌روند.
  4. "singleInstance"
    رفتار آن مانند "singleTask" است، با این تفاوت که سیستم هیچ فعالیت دیگری را در تکلیفی که نمونه را نگه می‌دارد راه‌اندازی نمی‌کند. فعالیت همیشه تنها عضو تکلیف خود است. هر فعالیتی که توسط این فعالیت شروع شود، در تکلیف جداگانه‌ای باز می‌شود.
  5. "singleInstancePerTask"
    فعالیت فقط می‌تواند به‌عنوان فعالیت ریشه تکلیف اجرا شود، اولین فعالیتی که تکلیف را ایجاد کرده است، بنابراین فقط یک نمونه از این فعالیت می‌تواند در یک تکلیف وجود داشته باشد. برخلاف حالت راه‌اندازی singleTask، این فعالیت می‌تواند در چندین نمونه در تکالیف مختلف شروع شود اگر پرچم FLAG_ACTIVITY_MULTIPLE_TASK یا FLAG_ACTIVITY_NEW_DOCUMENT تنظیم شده باشد.

برای مثال، «مرورگر Android» مقدار singleTask را در <activity> مشخص می‌کند، بنابراین فعالیت آن در تکلیف برنامه‌تان قرار نمی‌گیرد. درعوض، یا تکلیف جدیدی برای «مرورگر» شروع می‌شود یا تکلیف پس‌زمینه «مرورگر» موجودی جلو می‌آید.

صرف‌نظر از اینکه فعالیتی در تکلیف جدیدی شروع شود یا در همان تکلیفی که فعالیت آن را شروع کرده است، دکمه و اشاره «برگشت» همیشه کاربر را به فعالیت قبلی می‌برد. اما اگر فعالیتی را شروع کنید که حالت راه‌اندازی singleTask را مشخص می‌کند و نمونه‌ای از آن فعالیت در تکلیف پس‌زمینه وجود داشته باشد، کل آن تکلیف به پیش‌زمینه آورده می‌شود. در این مرحله، پشته قبلی‌ها شامل همه فعالیت‌های تکلیفی است که به بالای پشته آورده شده است. شکل ۴ این نوع سناریو را نشان می‌دهد.

شکل ۴. نمایشی از نحوه اضافه شدن فعالیتی با حالت راه‌اندازی "singleTask" به پشته قبلی‌ها. اگر فعالیت ازقبل بخشی از تکلیف پس‌زمینه‌ای با پشته قبلی‌های خودش باشد، آنگاه کل آن پشته قبلی‌ها نیز جلو می‌آید و در بالای تکلیف کنونی قرار می‌گیرد.

برای اطلاعات بیشتر درباره استفاده از حالت‌های راه‌اندازی در فایل مانیفست، به سند عنصر <activity> مراجعه کنید.

تعریف حالت‌های راه‌اندازی بااستفاده از پرچم‌های Intent

هنگام شروع یک فعالیت، می‌توانید ارتباط پیش‌فرض یک فعالیت را با وظیفه آن با گنجاندن پرچم‌ها در قصدی که به startActivity() ارائه می‌دهید، تغییر دهید. پرچم‌هایی که می‌توانید برای اصلاح رفتار پیش‌فرض استفاده کنید به شرح زیر است:

FLAG_ACTIVITY_NEW_TASK

سیستم فعالیت را در تکلیف جدیدی شروع می‌کند. اگر تکلیفی ازقبل برای فعالیتی که شروع شده است درحال اجرا باشد، آن تکلیف با آخرین وضعیت بازیابی‌شده‌اش به پیش‌زمینه آورده می‌شود و فعالیت، هدف جدید را در onNewIntent() دریافت می‌کند.

این کار همان رفتاری را ایجاد می‌کند که مقدار "singleTask" launchMode در بخش قبلی مورد بحث قرار گرفت.

FLAG_ACTIVITY_SINGLE_TOP

اگر فعالیتی که شروع می‌شود فعالیت فعلی باشد، در بالای پشته قبلی‌ها، نمونه موجود به‌جای ایجاد نمونه جدیدی از فعالیت، تماسی با onNewIntent() دریافت می‌کند.

این کار همان رفتاری را ایجاد می‌کند که مقدار "singleTop" launchMode که در بخش قبلی بحث شد ایجاد می‌کند.

FLAG_ACTIVITY_CLEAR_TOP

اگر فعالیتی که شروع می‌شود ازقبل در تکلیف فعلی درحال اجرا باشد، سیستم به‌جای راه‌اندازی نمونه جدیدی از آن فعالیت، همه فعالیت‌های دیگر را که بالاتر از آن قرار دارند ازبین می‌برد. هدف ازطریق onNewIntent() به نمونه ازسرگرفته‌شده فعالیت که اکنون در بالا قرار دارد ارسال می‌شود.

هیچ مقداری برای مشخصه launchMode که این رفتار را ایجاد می‌کند وجود ندارد.

FLAG_ACTIVITY_CLEAR_TOP اغلب در ارتباط با FLAG_ACTIVITY_NEW_TASK استفاده می‌شود. وقتی این پرچم‌ها باهم استفاده می‌شوند، فعالیت موجودی را در تکلیف دیگری پیدا می‌کنند و آن را در موقعیتی قرار می‌دهند که بتواند به هدف پاسخ دهد.

مدیریت علایق

قرابت نشان می‌دهد که یک فعالیت «ترجیح می‌دهد» به کدام تکلیف تعلق داشته باشد. به‌طور پیش‌فرض، همه فعالیت‌های یک برنامه با یکدیگر همبستگی دارند: آن‌ها «ترجیح می‌دهند» در یک تکلیف باشند.

بااین‌حال، می‌توانید تمایل پیش‌فرض را برای فعالیت تغییر دهید. فعالیت‌های تعریف‌شده در برنامه‌های مختلف می‌توانند خویشاوندی مشترک داشته باشند، و فعالیت‌های تعریف‌شده در یک برنامه می‌توانند خویشاوندی‌های تکلیف متفاوتی داشته باشند.

می‌توانید بااستفاده از مشخصه taskAffinity عنصر <activity>، وابستگی فعالیت را اصلاح کنید.

مشخصه taskAffinity مقدار رشته‌ای را می‌گیرد که باید با نام بسته پیش‌فرض اعلام‌شده در عنصر <manifest> متفاوت باشد، زیرا سیستم از آن نام برای شناسایی وابستگی پیش‌فرض تکلیف برای برنامه استفاده می‌کند.

این تمایل در دو شرایط وارد بازی می‌شود:

  1. وقتی قصدی که فعالیتی را راه‌اندازی می‌کند حاوی پرچم FLAG_ACTIVITY_NEW_TASK باشد.

    به‌طور پیش‌فرض، فعالیت جدیدی در تکلیف فعالیتی که startActivity() را فراخوانی کرده است راه‌اندازی می‌شود. این فعالیت به همان پشته قبلی‌ها که تماس‌گیرنده در آن قرار دارد منتقل می‌شود.

    بااین‌حال، اگر هدف ارسال‌شده به startActivity() حاوی پرچم FLAG_ACTIVITY_NEW_TASK باشد، سیستم به‌دنبال تکلیف دیگری برای قرار دادن فعالیت جدید می‌گردد. اغلب، این تکلیف جدیدی است. اما لازم نیست این‌طور باشد. اگر تکلیف موجودی با همان وابستگی فعالیت جدید وجود داشته باشد، فعالیت در آن تکلیف راه‌اندازی می‌شود. اگر نه، تکلیف جدیدی را شروع می‌کند.

    اگر این پرچم باعث شود فعالیتی تکلیف جدیدی را شروع کند و کاربر از دکمه یا اشاره «صفحه اصلی» برای ترک آن استفاده کند، باید راهی برای کاربر وجود داشته باشد تا به تکلیف برگردد. برخی‌از نهادها، مثل مدیر اعلان، همیشه فعالیت‌ها را در تکلیف خارجی شروع می‌کنند، نه به‌عنوان بخشی از تکلیف خودشان، بنابراین همیشه FLAG_ACTIVITY_NEW_TASK را در هدف‌هایی که به startActivity() ارسال می‌کنند قرار می‌دهند.

    اگر یک نهاد خارجی بتواند فعالیت شما را با این پرچم فراخوانی کند، راهی مستقل برای بازگشت به کاربران ارائه دهید، مانند نماد راه‌انداز از فیلتر CATEGORY_LAUNCHER در فعالیت ریشه تکلیف. برای اطلاعات بیشتر، به شروع کردن تکلیف مراجعه کنید.

  2. وقتی فعالیتی دارای مشخصه allowTaskReparenting تنظیم‌شده روی "true" باشد.

    در این حالت، فعالیت می‌تواند از تکلیفی که در آن شروع می‌شود به تکلیفی که با آن همبستگی دارد منتقل شود، وقتی که آن تکلیف به پیش‌زمینه می‌آید.

    برای مثال، فرض کنید فعالیتی که شرایط آب‌وهوایی را در شهرهای انتخابی گزارش می‌دهد به‌عنوان بخشی از برنامه سفر تعریف شده است. این فعالیت همان وابستگی را دارد که سایر فعالیت‌ها در همان برنامه دارند (وابستگی پیش‌فرض برنامه) و می‌توان آن را با این مشخصه دوباره به والد نسبت داد.

    وقتی یکی از فعالیت‌های شما فعالیت گزارشگر آب‌وهوا را شروع می‌کند، در ابتدا به همان تکلیف فعالیت شما تعلق دارد. بااین‌حال، وقتی تکلیف برنامه سفر به پیش‌زمینه می‌آید، فعالیت گزارشگر آب‌وهوا دوباره به آن تکلیف اختصاص داده می‌شود و در آن نمایش داده می‌شود.

پاک کردن پشته قبلی‌ها

اگر کاربر تکلیفی را برای مدت طولانی رها کند، سیستم تکلیف را از همه فعالیت‌ها به‌جز فعالیت ریشه پاک می‌کند. وقتی کاربر به تکلیف برمی‌گردد، فقط فعالیت ریشه بازیابی می‌شود. سیستم براساس این فرض این‌گونه رفتار می‌کند که پس‌از مدت زمان طولانی، کاربران کاری را که قبلاً انجام می‌دادند رها کرده‌اند و برای شروع کار جدیدی به آن تکلیف برمی‌گردند.

برخی‌از مشخصه‌های فعالیت وجود دارد که می‌توانید از آن‌ها برای اصلاح این رفتار استفاده کنید:

alwaysRetainTaskState
وقتی این مشخصه در فعالیت ریشه یک تکلیف روی "true" تنظیم شده باشد، رفتار پیش‌فرضی که شرح داده شد اتفاق نمی‌افتد. تکلیف همه فعالیت‌ها را در پشته خود حتی پس‌از مدت طولانی حفظ می‌کند.
clearTaskOnLaunch

وقتی این مشخصه در فعالیت ریشه یک تکلیف روی "true" تنظیم شده باشد، هرگاه کاربر تکلیف را ترک کند و به آن برگردد، تکلیف تا فعالیت ریشه پاک می‌شود. به عبارت دیگر، این برعکس alwaysRetainTaskState است. کاربر همیشه به تکلیف در حالت اولیه آن برمی‌گردد، حتی پس‌از ترک تکلیف برای یک لحظه.

finishOnTaskLaunch

این مشخصه مانند clearTaskOnLaunch است، اما روی یک فعالیت واحد عمل می‌کند، نه یک تکلیف کامل. همچنین می‌تواند باعث شود هر فعالیتی به‌جز فعالیت ریشه تمام شود. وقتی روی "true" تنظیم شده باشد، فعالیت فقط برای جلسه فعلی بخشی از تکلیف باقی می‌ماند. اگر کاربر از تکلیف خارج شود و سپس به آن برگردد، تکلیف دیگر وجود ندارد.

شروع کردن تکلیف

می‌توانید با دادن فیلتر قصد به یک فعالیت، آن را به‌عنوان نقطه ورودی برای یک تکلیف تنظیم کنید، به‌طوری‌که "android.intent.action.MAIN" به‌عنوان کنش مشخص‌شده و "android.intent.category.LAUNCHER" به‌عنوان دسته مشخص‌شده باشد:

<activity ... >
    <intent-filter ... >
        <action android:name="android.intent.action.MAIN" />
        <category android:name="android.intent.category.LAUNCHER" />
    </intent-filter>
    ...
</activity>

این فیلتر قصد نماد و برچسبی را برای فعالیت در راه‌انداز برنامه نمایش می‌دهد و به کاربران راهی برای راه‌اندازی فعالیت و بازگشت به تکلیفی که ایجاد می‌کند ارائه می‌دهد.

این توانایی دوم مهم است. کاربران باید بتوانند تکلیفی را ترک کنند و سپس بااستفاده از این راه‌انداز فعالیت، بعداً به آن برگردند. به همین دلیل، فقط از دو حالت راه‌اندازی که فعالیت‌ها را به‌عنوان همیشه آغازکننده یک تکلیف علامت‌گذاری می‌کنند، یعنی "singleTask" و "singleInstance"، استفاده کنید، زمانی که فعالیت دارای فیلتر ACTION_MAIN و CATEGORY_LAUNCHER باشد.

برای مثال، تصور کنید اگر فیلتر وجود نداشته باشد چه اتفاقی می‌افتد: یک هدف، فعالیت "singleTask" را راه‌اندازی می‌کند و تکلیف جدیدی را آغاز می‌کند، و کاربر مدتی را صرف کار در آن تکلیف می‌کند. سپس کاربر از دکمه «صفحه اصلی» یا اشاره استفاده می‌کند. اکنون تکلیف به پس‌زمینه ارسال شده است و قابل‌مشاهده نیست. اکنون کاربر هیچ راهی برای بازگشت به تکلیف ندارد، زیرا در راه‌انداز برنامه نشان داده نمی‌شود.

برای مواردی که نمی‌خواهید کاربر بتواند به فعالیتی برگردد، finishOnTaskLaunch عنصر <activity> را روی "true" تنظیم کنید. برای اطلاعات بیشتر، به پاک کردن پشته قبلی‌ها مراجعه کنید.

برای کسب اطلاعات بیشتر درباره نحوه نمایش و مدیریت تکالیف و فعالیت‌ها در صفحه موارد اخیر، به صفحه موارد اخیر بروید.

منابع بیشتر