Divide and Conquer: composant de navigation dans un projet multi-module

Dans cet article, vous apprendrez comment organiser des graphiques de modules / fonctionnalités / user story individuels, les centraliser, créer une navigation directe entre eux et saupoudrer Safe Args avec un plugin sur le dessus.

Vous êtes maintenant dans la troisième partie d'un grand article sur le composant de navigation dans un projet multi-module . Si vous ne comprenez pas un seul mot ci-dessus, je vous exhorte à vous familiariser d'abord avec cela:

• Quelle bête ce composant de navigation est .

  
  
  
  
  

• Comment fonctionne le plugin Safe Args et ce qu'il fait .

  
  
  
  
  

Eh bien, si vous êtes déjà familier avec cette bibliothèque, alors il y a un bonus intéressant pour vous dans le prochain article - une approche pour organiser la navigation multipiste de type iOS .

Voyons d'abord à quoi ressemble la division du projet en modules dans notre entreprise dans laquelle je travaille ( magora-systems.com ):

1. : app est le module principal et le point d'entrée de l'application. Il a besoin de connaître tous les modules participant à l'application.

   
   
   
   
   

2. : core-module contient toutes les choses de base: classes de base, modèles, entité, DTO, extensions, etc. 

   
   
   
   
   

3. Les modules utilitaires sont utilisés pour encapsuler les fonctionnalités des principaux composants de l'application. Par exemple, travailler avec un réseau, une base de données ou la même navigation.

   
   
   
   
   

4. Les modules de fonctionnalités incluent le travail d'une fonctionnalité / histoire utilisateur spécifique, que ce soit un flux ou un écran.

   
   
   
   
   

, Safe Args .

, :

. , :

1. feature-.

   
   
   
   
   

2. Top-level .

   
   
   
   
   

3. .

   
   
   
   
   

4. , Top-level .

   
   
   
   
   

.

feature-

destination- , feature- . , Safe Args , , .

Top-level

— , , .

, .

, , global action.

, Top-level  

, :

1. (:core)

   
   
   
   
   

− , . − , . , Lint-a, .

− , , .

2. (:app)

   
   
   
   
   

+ .

− .

− Safe args global action- feature- , .

, :app-, Top-level . …

:

: (:navigation), , - .

id action-. generated- , , id .

<item name="actionglobalnavsignin" type="id"/>
<item name="actionglobalnavsignup" type="id"/>
<item name="actionglobalnavhome" type="id"/>
<item name="actionglobalnavuserslist" type="id"/>
<item name="actionglobalnavuserdetails" type="id"/>
<item name="actionglobalnavon¨C11Cglobal¨C12Csettings" type="id"/>
<item name="action¨C13Cto_faq" type="id"/>
      
      

        
        
        
      

    
        
        
        
      
      

        
        
        
      

    
    

: Directions Args :app  

Safe args global action- feature- , .

: generated-. -. Generated- build- , ( :app), :navigation- . : generateSafeArgs, , Args- Directions- R :app, .

ext {
   navigationArgsPath = '/build/generated/source/navigation-args'
   appNavigation = "${project(':app).projectDir.path}$navigationArgsPath"
   navigationPath = "${project(':navigation').projectDir.path}$navigationArgsPath"
   navigationPackage = “com.example.navigation”
}

tasks.whenTaskAdded { task ->
   if (task.name.contains('generateSafeArgs')) {
       task.doLast {
           fileTree(appNavigation)
                   .filter { it.isFile() && it.name.contains("Directions") }
                   .forEach { file ->
                       if (file.exists()) {
                           def lines = file.readLines()
                           lines = lines.plus(2, "import $navigationPackage.R")
                           file.text = lines.join("\n")
                       }
                   }
       }
       move(file("$appNavigation"), file("$navigationPath"))
   }
}
      
      

        
        
        
      

    
        
        
        
      
      

        
        
        
      

    
    

, , . - , , , . 

— , sourceSet-s .

Je ne me suis pas attardé sur cette victoire et j'ai décidé de voir ce qui pouvait être fait d’autre à ce sujet. Pour cela, un projet dans lequel le client voulait une application avec un menu en bas et que chaque onglet conserve son état en le quittant s'est avéré utile comme jamais auparavant. C'est à propos de cette décision que porte la dernière partie de mon histoire sur la navigation multistack de type iOS .