35 readd deep linking

app/src/main/AndroidManifest.xml

@@ -37,7 +37,9 @@
             android:name=".controllers.main.MainActivity"
             android:label="@string/brand_name"
             android:launchMode="singleTop"
-            android:theme="@style/AppTheme.TranslucentStatus" />
+            android:theme="@style/AppTheme.TranslucentStatus">
+            <nav-graph android:value="@navigation/main" />
+        </activity>
 
         <activity android:name=".controllers.login.LoginActivity" />
 

app/src/main/java/org/schulcloud/mobile/controllers/homework/HomeworkFragment.kt

@@ -26,7 +26,7 @@ class HomeworkFragment : MainFragment() {
 
 
     override var url: String? = null
-        get() = "homework/${viewModel.homework.value?.id}"
+        get() = "/homework/${viewModel.homework.value?.id}"
 
     override fun provideConfig() = viewModel.homework
             .map { homework ->

app/src/main/java/org/schulcloud/mobile/controllers/news/NewsFragment.kt

@@ -23,7 +23,7 @@ class NewsFragment : MainFragment() {
 
 
     override var url: String? = null
-        get() = "news/${viewModel.news.value?.id}"
+        get() = "/news/${viewModel.news.value?.id}"
 
     override fun provideConfig() = viewModel.news
             .map { news ->

app/src/main/java/org/schulcloud/mobile/network/ApiService.kt

@@ -18,7 +18,7 @@ object ApiService {
     fun getInstance(): ApiServiceInterface {
 
         val loggingInterceptor = HttpLoggingInterceptor()
-        loggingInterceptor.level = HttpLoggingInterceptor.Level.BODY
+        loggingInterceptor.level = HttpLoggingInterceptor.Level.BASIC
 
         val client = OkHttpClient.Builder()
                 .addInterceptor { chain ->

app/src/main/java/org/schulcloud/mobile/viewmodels/IdViewModelFactory.kt

@@ -2,11 +2,15 @@ package org.schulcloud.mobile.viewmodels
 
 import androidx.lifecycle.ViewModel
 import androidx.lifecycle.ViewModelProvider
+import org.schulcloud.mobile.utils.trimTrailingSlash
 
 class IdViewModelFactory(private val id: String) : ViewModelProvider.NewInstanceFactory() {
 
     @Suppress("UNCHECKED_CAST")
     override fun <T : ViewModel?> create(modelClass: Class<T>): T {
+        // Deep linking also matches a trailing slash
+        val id = id.trimTrailingSlash()
+
         return when (modelClass) {
             NewsViewModel::class.java -> NewsViewModel(id) as T
             CourseViewModel::class.java -> CourseViewModel(id) as T

app/src/main/res/navigation/main.xml

@@ -4,7 +4,8 @@
     xmlns:app="http://schemas.android.com/apk/res-auto"
     xmlns:tools="http://schemas.android.com/tools"
     android:id="@+id/main"
-    app:startDestination="@id/fragment_dashboard">
+    app:startDestination="@id/fragment_dashboard"
+    tools:ignore="UnusedAttribute">
 
     <fragment
         android:id="@+id/fragment_dashboard"
@@ -25,30 +26,59 @@
         <action
             android:id="@+id/action_dashboardFragment_to_fileOverviewFragment"
             app:destination="@id/fragment_fileOverview" />
+
+        <deepLink
+            android:autoVerify="true"
+            app:uri="schul-cloud.org/dashboard" />
+        <deepLink
+            android:autoVerify="true"
+            app:uri="schul-cloud.org/dashboard/" />
     </fragment>
 
+
     <!-- News -->
     <fragment
         android:id="@+id/fragment_newsList"
         android:name="org.schulcloud.mobile.controllers.news.NewsListFragment"
-        tools:layout="@layout/fragment_news_list" />
+        tools:layout="@layout/fragment_news_list">
+        <deepLink
+            android:autoVerify="true"
+            app:uri="schul-cloud.org/news" />
+        <deepLink
+            android:autoVerify="true"
+            app:uri="schul-cloud.org/news/" />
+    </fragment>
+
     <fragment
         android:id="@+id/fragment_news"
         android:name="org.schulcloud.mobile.controllers.news.NewsFragment"
         tools:layout="@layout/fragment_news">
         <argument
             android:name="id"
             app:argType="string" />
+
+        <deepLink
+            android:autoVerify="true"
+            app:uri="schul-cloud.org/news/{id}" />
     </fragment>
     <action
         android:id="@+id/action_global_fragment_news"
         app:destination="@id/fragment_news" />
 
+
     <!-- Course -->
     <fragment
         android:id="@+id/fragment_courseList"
         android:name="org.schulcloud.mobile.controllers.course.CourseListFragment"
-        tools:layout="@layout/fragment_course_list" />
+        tools:layout="@layout/fragment_course_list">
+        <deepLink
+            android:autoVerify="true"
+            app:uri="schul-cloud.org/courses" />
+        <deepLink
+            android:autoVerify="true"
+            app:uri="schul-cloud.org/courses/" />
+    </fragment>
+
     <fragment
         android:id="@+id/fragment_course"
         android:name="org.schulcloud.mobile.controllers.course.CourseFragment"
@@ -60,36 +90,56 @@
     <action
         android:id="@+id/action_global_fragment_course"
         app:destination="@id/fragment_course" />
+
     <fragment
         android:id="@+id/fragment_topic"
         android:name="org.schulcloud.mobile.controllers.topic.TopicFragment"
         tools:layout="@layout/fragment_topic">
         <argument
             android:name="id"
             app:argType="string" />
+
+        <!-- Disabled because some types of content are not supported yet. That way, you can still open it externally. -->
+        <!--<deepLink
+            android:autoVerify="true"
+            app:uri="schul-cloud.org/courses/{courseId}/topics/{id}" />-->
     </fragment>
     <action
         android:id="@+id/action_global_fragment_topic"
         app:destination="@id/fragment_topic" />
 
+
     <!-- Calendar -->
     <!--<fragment
         android:id="@+id/fragment_calendar"
         android:name="org.schulcloud.mobile.controllers.main.CalendarFragment"
         tools:layout="@layout/fragment_calendar" />-->
 
+
     <!-- Task -->
     <fragment
         android:id="@+id/fragment_homeworkList"
         android:name="org.schulcloud.mobile.controllers.homework.HomeworkListFragment"
-        tools:layout="@layout/fragment_homework_list" />
+        tools:layout="@layout/fragment_homework_list">
+        <deepLink
+            android:autoVerify="true"
+            app:uri="schul-cloud.org/homework" />
+        <deepLink
+            android:autoVerify="true"
+            app:uri="schul-cloud.org/homework/" />
+    </fragment>
+
     <fragment
         android:id="@+id/fragment_homework"
         android:name="org.schulcloud.mobile.controllers.homework.HomeworkFragment"
         tools:layout="@layout/fragment_homework">
         <argument
             android:name="id"
             app:argType="string" />
+
+        <deepLink
+            android:autoVerify="true"
+            app:uri="schul-cloud.org/homework/{id}" />
     </fragment>
     <action
         android:id="@+id/action_global_fragment_homework"
@@ -99,7 +149,15 @@
     <fragment
         android:id="@+id/fragment_fileOverview"
         android:name="org.schulcloud.mobile.controllers.file.FileOverviewFragment"
-        tools:layout="@layout/fragment_file_overview" />
+        tools:layout="@layout/fragment_file_overview">
+        <deepLink
+            android:autoVerify="true"
+            app:uri="schul-cloud.org/files" />
+        <deepLink
+            android:autoVerify="true"
+            app:uri="schul-cloud.org/files/" />
+    </fragment>
+
     <fragment
         android:id="@+id/fragment_file"
         android:name="org.schulcloud.mobile.controllers.file.FileFragment"

supported-links.md

@@ -0,0 +1,18 @@
+Schemes: `http`, `https`  
+Host: `schul-cloud.org`  
+
+
+| Name          | Path           | Comments                                      |
+| ------------- | -------------- | --------------------------------------------- |
+| Dashboard     | /dashboard     |                                               |
+| News list     | /news          |                                               |
+| News          | /news/{id}     |                                               |
+| Course list   | /courses       |                                               |
+| Course        |                | Not supported<sup>1</sup>                     |
+| Topic         |                | Disabled as some content is not supported yet |
+| Homework list | /homework      |                                               |
+| Homework      | /homework/{id} |                                               |
+| File overview | /files         |                                               |
+| Folder        |                | Not supported (shared not implemented)        |
+
+*<sup>1</sup> Note: Lazy matching is not supported! Hence `/courses/{courseId}/topics/{id}` is matched by `/courses/{id}`.*