Поведение зафиксированных ярлыков MAUI

Вопрос или проблема

Ответ или решение

Поведение закрепленных ярлыков в MAUI: Полное руководство

Введение

При миграции приложения с использованием Xamarin на MAUI многие разработчики сталкиваются с вопросами относительно поведения закрпленных ярлыков, особенно для вторичных активностей в Android. В этом контексте мы рассмотрим вашу проблему с настройкой второго ярлыка и попробуем дать рекомендации по его правильной настройке и реализации.

Проблема

Вы указали на несколько ключевых проблем, возникающих при работе с MAUI:

1. Неправильный запуск активити: При запуске приложения вместо MainActivity запускается SecondaryActivity, несмотря на выставленный параметр MainLauncher = true.

2. Проблемы со сплэш-экраном: При нажатии на ярлык приложение показывает сплэш-экран, указывающий на его повторный запуск, после чего открывается SecondaryActivity.

3. Краш при закрытом приложении: При попытке запустить приложение из ярлыка, оно крашится из-за ошибки, связанной с несовпадением свойств на уровне UI.

Анализ

1. Неправильный запуск активити

Проблема с тем, что SecondaryActivity запускается вместо MainActivity, может быть связана с неправильной настройкой IntentFilter для SecondaryActivity. В MAUI настройка фильтров может иметь другую логику. Если не требуется, чтобы SecondaryActivity была основной, удаление Categories = new[] { Intent.CategoryLauncher } может быть правильным шагом.

2. Сплэш-экран

Появление сплэш-экрана при запуске приложения связано с тем, что Android повторно инициализирует приложение при запуске SecondaryActivity. Это может указывать на проблемы с конфигурацией LaunchMode. Параметры SingleTask или SingleInstance могут не работать должным образом в контексте MAUI. Рекомендуется устанавливать LaunchMode только для MainActivity и обеспечить, чтобы SecondaryActivity не вмешивалась в логическую инициализацию вашего приложения.

3. Краш приложения

Ошибка Cannot assign property "TextColor": Property does not exist, or is not assignable, or mismatching type between value and property может быть вызвана попыткой доступа к несуществующим свойствам UI при загрузке MainPage. Это может быть связано с тем, что сессии инициализации различаются между активностями в MAUI и Xamarin. В этом случае желательно откатить изменение конфигурации и удостовериться, что все элементы UI корректно инициализированы.

Рекомендации по реализации закрпленных ярлыков в MAUI

1. Настройка активностей:

   • Убедитесь, что MainActivity настроена как основной с использованием параметров:

     [Activity(Label = "MainActivity", Icon = "@mipmap/icon", RoundIcon = "@mipmap/icon_round", Theme = "@style/MainTheme", MainLauncher = true)]
     public class MainActivity : MauiAppCompatActivity { }

   • Для SecondaryActivity используйте:

     [Activity(Label = "SecondaryActivity", Exported = true, SupportsPictureInPicture = true)]
     [IntentFilter(new[] { Intent.ActionCreateShortcut }, Categories = new[] { Intent.CategoryDefault })]
     public class SecondaryActivity : Activity { }

2. Обработка SHORTCUT Intent:

   • Для корректного управления событиями от закрпленных ярлыков рассмотрите возможность обработки Intent в MauiProgram или в MainApplication. Например:

     protected override void OnCreate(Bundle savedInstanceState)
     {
     base.OnCreate(savedInstanceState);
     // Обработка Intent для SHORTCUT
     var intent = Intent;
     if (intent.Action == Intent.ActionView)
     {
         OpenSecondaryActivity();
     }
     }

3. Доступ к свойствам UI:

   • Проверьте вашу разметку и классы представлений на наличие ошибок привязки и инициализации. Все зависимости должны быть корректно установлены и инициализированы до того, как вы будете пытаться их использовать.

Заключение

Настройка закрпленных ярлыков в MAUI требует более тщательной проработки, чем в Xamarin, и может быть источником новых проблем. Рекомендуется тщательно проверять конфигурацию активностей и корректно обрабатывать Intent, чтобы обеспечить стабильную работу приложения. Надеюсь, вышеприведённые рекомендации помогут вам успешно решить вопросы, связанные с миграцией приложения.