Многомодульная навигация с компонентами архитектуры
Итак, у меня есть эта структура для моих модулей в моем текущем приложении.
Я не нашел никакой официальной документации по мультимодульной навигации, но нашел эту статью, так что вот мои файлы Gradle:
Особенность 1 - Деталь
...
implementation project(":base")
implementation project(":feature-2-detail")
...
Функция 2 - Подробно
...
implementation project(":base")
implementation project(":feature-1-detail")
...
Функция 3 - Подробно
...
implementation project(":base")
implementation project(":feature-1-detail")
...
А вот мои навигационные графики:
Особенность 1 - Деталь
<navigation ...
android:id="@+id/graph_feature_1_id">
<include app:graph="@navigation/graph_feature_2" />
<fragment ...
android:id="@+id/nav_feature_1">
<action ...
app:destination="@+id/graph_feature_2_id" />
</fragment>
</navigation>
Функция 2 - Подробно
<navigation ...
android:id="@+id/graph_feature_2_id">
<include app:graph="@navigation/graph_feature_1" />
<fragment ...
android:id="@+id/nav_feature_2">
<action ...
app:destination="@+id/graph_feature_1_id" />
</fragment>
</navigation>
Функция 3 - Подробно
<navigation ...
android:id="@+id/graph_feature_3_id">
<include app:graph="@navigation/graph_feature_1" />
<fragment ...
android:id="@+id/nav_feature_3">
<action ...
app:destination="@+id/graph_feature_1_id" />
</fragment>
</navigation>
Итак, все работает с такого рода настройкой, но проблема здесь в том, что для подключения модуля к другому модулю мы должны добавить другую функцию в качестве зависимости от текущей функции. Как и в моем случае, Feature 1 - Detail может перейти к Feature 2 - Detail и наоборот, и при этом я получаю круговую зависимость в gradle.
Есть ли другой способ сделать многомодульную навигацию? Я пытался использовать глубокие ссылки, но безрезультатно.
Любая помощь будет оценена! Спасибо!
Ответы
Ответ 1
Это уже год, но библиотека теперь может поддерживать именно этот вариант использования! Начиная с 2.1.0-alpha03 мы можем перемещаться по URI с глубокими ссылками.
Вместо того, чтобы добавлять функции как детали реализации друг к другу, мы можем оставить их неосознанными между собой и использовать навигацию с использованием глубоких ссылок.
Особенность 1 - Деталь - build.gradle
dependencies {
implementation project(':base')
}
То же самое с функцией 2 - подробности. Нет необходимости знать другие модули.
Чтобы иметь межмодульную навигацию, мы должны сначала определить глубокую ссылку для навигации по этому месту назначения с помощью тега deepLink
.
Особенность 1 - Деталь - График навигации
<navigation ...
android:id="@+id/graph_feature_1_detail_id">
<fragment ...
android:id="@+id/nav_feature_1_detail">
<deepLink app:uri="myApp://feature1detail"/>
</fragment>
</navigation>
Функция 2 - Подробно - График навигации
<navigation ...
android:id="@+id/graph_feature_2_detail_id">
<fragment ...
android:id="@+id/nav_feature_2_detail">
<deepLink app:uri="myApp://feature2detail"/>
</fragment>
</navigation>
Теперь, когда у нас есть глубокие ссылки с установленными URI, мы можем напрямую использовать это в NavController
Так во фрагменте в Feature 1 - Detail, может быть, по нажатию кнопки? Везде, где вы должны выполнять навигацию
class Feature1DetailFragment {
fun onViewCreated(...) {
...
view.setOnClickListener {
val uri = Uri.parse("myApp://feature2detail")
findNavController().navigate(uri)
}
}
}
А в Feature 2 - Detail,
class Feature2DetailFragment {
fun onViewCreated(...) {
...
view.setOnClickListener {
val uri = Uri.parse("myApp://feature1detail")
findNavController().navigate(uri)
}
}
}
И вуаля! Межмодульная навигация.
На момент написания статьи последний стабильный выпуск был 2.1.0-rc01
.
Хотя я не пробовал это на более сложных проектах, мне нравится эта библиотека, и я надеюсь, что эта библиотека станет более зрелой!
Я создал среднюю статью об этом. Вы можете взглянуть на это. Ура!
Ответ 2
Можно удалить все зависимые зависимости Gradle, когда вы объявляете каждый идентификатор графического символа функции явно в базовой функции. Я не на 100% удовлетворен этим решением, так как эти идентификаторы создают "скрытые" зависимости между функциями, но в остальном они отлично работают.
Вот основные части этой настройки:
:приложение
build.gradle
dependencies {
implementation project(':features:feature-base')
implementation project(':features:feature-one')
implementation project(':features:feature-two')
}
: особенности: функция базы
build.gradle
dependencies {
application project(':app')
feature project(':features:feature-one')
feature project(':features:feature-two')
}
навигации /feature_base_nav_graph.xml
<navigation ...>
<include app:graph="@navigation/feature_one_nav_graph" />
<include app:graph="@navigation/feature_two_nav_graph" />
</navigation>
Значения /feature_base_ids.xml
<resources>
<item name="feature_one_nav_graph" type="id" />
<item name="feature_two_nav_graph" type="id" />
</resources>
: особенности: функция-один
build.gradle
dependencies {
implementation project(':features:feature-base')
}
навигации /feature_one_nav_graph.xml
<navigation
android:id="@id/feature_one_nav_graph"
...>
<fragment
android:id="@+id/oneFragment"
...>
<action
android:id="@+id/navigateToFeatureTwo"
app:destination="@id/feature_two_nav_graph"
... />
</fragment>
</navigation>
проводить
findNavController().navigate(R.id.navigateToFeatureTwo)
: Особенности: функция-два
build.gradle
dependencies {
implementation project(':features:feature-base')
}
навигации /feature_two_nav_graph.xml
<navigation
android:id="@id/feature_two_nav_graph"
...>
<fragment
android:id="@+id/twoFragment"
...>
<action
android:id="@+id/navigateToFeatureOne"
app:destination="@id/feature_one_nav_graph"
... />
</fragment>
</navigation>
проводить
findNavController().navigate(R.id.navigateToFeatureOne)
Ответ 3
Один из подходов, который может быть полезен, - это создание совершенно нового независимого модуля (например, модуля ": навигация") и перемещение в него всех файлов navigation.xml из всех других модулей. Затем мы зависим от этого нового (": navigation") модуля во всех других модулях, где требуется материал, связанный с навигацией, и мы сможем получить доступ к его R.navigation или сгенерированным классам аргументов и т.д.
Поскольку новый модуль (": navigation") ничего не знает в IDE проекта, он будет помечать красным любой фрагмент, действие и другие классы, которые мы используем в файлах navigation.xml, которые определены снаружи в других модулях, но пока мы используйте полные имена классов (com.exampel.MyFragment), они будут компилироваться и работать.
<?xml version="1.0" encoding="utf-8"?>
<navigation
xmlns:android="http://schemas.android.com/apk/res/android"
xmlns:app="http://schemas.android.com/apk/res-auto"
android:id="@+id/nav_graph_id"
app:startDestination="@id/some_navigation_id">
<fragment
android:id="@+id/some_navigation_id"
android:name="com.exampel.MyFragment".../>
// com.exampel.MyFragment will be marked red since IDE can't link it
// to the existing class because it is in the other module
Это создает "скрытую" зависимость от всех классов, к которым мы хотим перейти, таким образом, что нам нужно знать имена классов и потенциальные аргументы, и мы должны поддерживать это вручную, но это позволяет нам легко разделить навигацию в независимом модуле.