42 votes

Conventions de dénomination des fichiers de mise en page?

Quelles sont les conventions de dénomination des fichiers de mise en page que les utilisateurs ont élaborées.

Je n'ai rien trouvé en ligne, mais j'ai pensé à utiliser la convention suivante.

Que pense tout le monde?

  - activity_* 
 - dialog_*
 - list_item_*
 

C'est tout ce avec quoi j'ai travaillé jusqu'à présent.

Et qu'en est-il de la dénomination de l'activité par rapport à sa mise en page? Par exemple:

 -> res
    -> layout
        -> activity_about_us.xml
-> src
    -> activity
        -> AboutUs.java
 

30voto

Ogre_BGR Points 4799

Curieusement, en essayant de google à cette question n'apporte que cette page de résultat significatif... Pour la moitié de la dernière année, je suis en utilisant la convention d'affectation de noms similaires à la vôtre, mais avec des temps de préfixes. Par exemple: Pour les activités qui montre "à Propos de nous" écran:

Nom de la classe: ActAboutUs. La préfixation de classe est une sorte de exagérée, mais elle fait clairement la distinction classes d'activité des autres. J'ai d'abord utilisé répertoire distinct pour toutes les activités (similaire à votre approche), mais après un certain temps, j'ai réalisé que pour les plus gros apps peut-être il est préférable de groupe dans des répertoires en fonction que par la super-classe (c'est à dire de l'Activité). Il est plus facile pour moi de travailler dans un seul répertoire, par exemple /src/settings/ quand je travaille sur Paramètres. De cette façon, tous les fichiers java que j'ai besoin dans un seul dir, donc je ne pas avoir à se promener autour de:

/src/settings/ActSettingsGlobal.java
/src/settings/ActSettingsNet.java
/src/settings/Settings.java
/src/settings/SettingsDBAdapter.java
/src/settings/etc...

Cette approche permet également de répartir le travail entre les différents développeurs, c'est à dire chacun travaille dans son propre dir sur la fonction séparée donc pas marcher sur les pieds les uns des autres :-).

Certaines personnes préférez les suffixes, mais je l'ai trouvé moins utiles. Les préfixes de l'aide à un groupe de choses par ordre alphabétique comme dans l'exemple ci-dessus: Act* préfixe est d'abord triées donc toutes les activités sont idéalement au sommet.

Je suis même en tenant compte de l'utilisation de Act_ comme un préfixe qui est plus lisible mais il est en conflit avec les conventions de nommage java...

Nom du fichier Layout: act_about_us.xml. En res/layout/ nous n'avons pas le "luxe" des sous-dossiers qui est tout à fait regrettable de sorte que le seul groupe de choses, c'est à l'aide de préfixe approprié comme act_, dlg_, etc...

String Id: <string name="act_about_us_dlg_help1_title" ... string.xml est l'endroit où nous avons le plus de problèmes avec des doublons names. Il est très facile de créer des doublons si la convention de nommage comme activity_element_item n'est pas utilisé. Il ajoute beaucoup de supplémentaires de frappe, mais il vous permet d'économiser de beaucoup de confusion plus tard. Pour global (application à l'échelle) les chaînes de caractères que nous utilisons le préfixe "global_", par exemple global_btn_ok, global_msg_no_inet_conn. Habituellement nous faire une personne responsable pour tous global_ chaînes de caractères, donc si quelqu'un a besoin d'une nouvelle chaîne ou de changement dont il a besoin pour se synchroniser avec lui afin d'éviter de créer un désordre.

(maintenant je me rends compte qu' activity__element__item (deux caractères de soulignement) est plus claire et plus lisible qu' activity_element_item)

Dans l'ensemble je n'arrive toujours pas à se débarrasser du sentiment qu'il ya quelque chose de mal avec ma démarche, car je ne peux pas croire que les devs google a créé un tel inconvénient cadre quand il s'agit de travailler avec des fichiers, Id, noms, etc...

9voto

Sunil Pandey Points 3605

Je pense que la convention de dénomination suivante devrait être suivie

pour l'activité

si le nom de notre activité est

 DisplayListActivity
 

alors notre layoutname devrait être

 display_list_activity.xml
 

pour les éléments de liste, nous pouvons inclure une catégorie dans le nom de la disposition des éléments de liste

 country_list_item.xml
 

et pour les boîtes de dialogue, leur action peut être incluse

 delete_country_dialog.xml
 

7voto

Molimo Points 11

Lors de la recherche d'un groupe de mises en page, qui est la façon dont j'ai tendance à travailler sur eux, je trouve efficace à toujours faire précéder le nom de la classe et de suivi avec tous les sous-modèles. Par Exemple:

Nom De La Classe: AboutActivity.java
Nom Du Modèle: about_activity.xml
Sous-Nom du modèle: about_activity_menu.xml
Sous-sous-disposition Nom: about_activity_menu_item.xml

Votre activité sera toujours en haut de chaque groupement et de la chasse pour les non-activités devient de moins en moins d'une corvée. Quelqu'un sait pourquoi les sous-dossiers ne sont pas une chose encore? J'attends pour l'efficacité et la simplicité sur le back-end, mais j'imagine que ce ne serait pas trop mal.

Prograide.com

Prograide est une communauté de développeurs qui cherche à élargir la connaissance de la programmation au-delà de l'anglais.
Pour cela nous avons les plus grands doutes résolus en français et vous pouvez aussi poser vos propres questions ou résoudre celles des autres.

Powered by:

X