Importació d'un mòdul al repositori

En aquesta secció, analitzarem com posar un projecte nou al repositori de CVS. Si només voleu treballar amb el projecte existent que ja es troba en un repositori, podeu saltar-vos aquesta secció.

Hi ha dues maneres de posar un projecte al CVS:

  • Importar els fitxers i les carpetes a un mòdul nou, utilitzant el diàleg d'importació del Cervisia. Els mòduls són les carpetes superiors a l'arbre de carpetes del repositori de CVS i s'utilitzen per a separar i organitzar els diferents projectes de programari dintre del repositori.

  • Crear un mòdul buit i afegir fitxers i carpetes noves manualment. Tindreu més control, però probablement trigareu una mica més de temps.

Important

Tingueu en compte que el CVS fou dissenyat inicialment per a gestionar fitxers de text. Moltes característiques, com ara la fusió de les revisions, la creació de les diferències de forma que siguin llegibles, etc. només són efectuades en els fitxers de text. Això no vol dir que no pugueu utilitzar el CVS per a mantenir fitxers binaris, senzillament significa que heu d'especificar explícitament al CVS si és un fitxer de text o un fitxer binari. Si declareu un tipus de fitxer erroni, tindreu problemes amb la funcionalitat del CVS per a aquests fitxers i es podrien corrompre.

La importació d'un projecte (com un mòdul nou) té alguns avantatges: importareu tots els fitxers i carpetes recursivament, i el mòdul es crearà automàticament. Això simplifica la importació de grans projectes existents en el repositori. No obstant això, hi ha alguns desavantatges: no es pot utilitzar el diàleg d'importació del Cervisia per a afegir fitxers als mòduls existents, i podeu importar els fitxers tant de text com binaris. Podeu solucionar aquesta limitació mitjançant la creació d'una carpeta amb els fitxers de només un dels tipus, o informar dels patrons dels fitxers que s'hauran d'ignorar en el procés d'importació.

Per exemple, suposant que el vostre projecte només contingui fitxers de text i algunes imatges PNG (fitxers binaris). Podeu dir-li al CVS que ignori tots els fitxers que continguin el patró *.png mentre importa els altres fitxers com a text, o podeu moure les imatges a una carpeta separada i després importar els fitxers restants (com a fitxers de text). De qualsevol manera haureu de fer un checkout del mòdul importat recentment a una còpia de treball nova i copiar-ne els fitxers i carpetes restants, afegir i cometre al repositori per a completar el procés d'importació.

Alternativament, podeu afegir els fitxers i les carpetes manualment, creant un mòdul buit. Per a afegir un mòdul buit a un repositori, simplement heu de crear una carpeta nova a la carpeta arrel del repositori de CVS. El nom d'aquesta carpeta serà el nom del mòdul. Feu un checkout del mòdul nou buit. Després copieu els fitxers i carpetes a la còpia de treball, feu afegeix i comet per a pujar-ho tot al repositori de CVS.

Figura 2.2. Una captura de pantalla del diàleg d'importació del Cervisia

Una captura de pantalla del diàleg d'importació del Cervisia

A la Figura 2.2, «Una captura de pantalla del diàleg d'importació del Cervisia» podeu veure el diàleg que us ajudarà a importar un projecte com a un mòdul. Per a accedir al diàleg d'importació del Cervisia, escolliu l'element RepositoriImporta... del menú.

Repositori:

Introduïu o seleccioneu des de la llista desplegable el nom del repositori de CVS, també conegut com a $CVSROOT. Haureu de tenir accés d'escriptura per a accedir-hi i el repositori haurà d'estar adequadament inicialitzat. Si el repositori encara no existeix, podeu crear-ne un seleccionant l'element RepositoriCrea... del menú.

La llista desplegable mostra una llista dels repositoris que heu introduït prèviament utilitzant el diàleg Configura l'accés als repositoris. Si el repositori és remot, assegureu-vos que l'autenticació funciona. Vegeu «Accedint al repositori» per a més informació.

Mòdul:

El nom del mòdul sota el qual serà emmagatzemat el projecte. Després d'importar-lo, el projecte es podrà extreure amb aquest nom. Vegeu «Extracció d'un mòdul del repositori» per a més informació. Aquest també és el nom de la carpeta corresponent en el repositori.

Carpeta de treball:

La carpeta de nivell superior del projecte que voleu importar. La importació comença a partir d'aquesta carpeta i baixa recursivament.

Etiqueta del distribuïdor:

L'etiqueta del distribuïdor s'ha emprat històricament pel seguiment del codi font de tercers. Només haureu d'utilitzar el vostre nom d'usuari si no teniu cap idea millor. El que introduïu aquí no importa massa.

Etiqueta de llançament:

Aquesta etiqueta també s'ha emprat històricament per a importar diferents versions del programari de tercers. Si no ho esteu fent, utilitzeu la paraula start o una cadena FOO_1.0 on FOO és el nom del projecte, i 1.0 és el número de la versió del llançament importat.

Ignora els fitxers:

Si empleneu aquest camp, es donarà una opció addicional -I noms_de_fitxer a l'ordre cvs import. Aquesta entrada serà interpretada com una llista de patrons de noms de fitxer separats per un espai que seran ignorats. En general una forma més neta i menys propensa a errors per a controlar quins fitxers van al repositori, és crear una carpeta amb només els fitxers que voleu importar i començar des d'aquesta carpeta. No obstant això, aquesta entrada pot ser útil si el projecte conté fitxers que són ignorats per defecte pel CVS, p. ex. fitxers amb el nom core, en aquest cas, simplement introduïu el caràcter ! en aquest camp: això redefineix l'esquema original dels fitxers ignorats pel CVS, vegeu «Fitxers ignorats».

Comentari:

Utilitzeu aquest camp per a enregistrar els comentaris que pugueu tenir sobre l'origen, ús, desenvolupament, etc. dels fitxers que esteu important.

Importa com a binaris

Si marqueu aquesta casella, tots els fitxers s'importaran en el mode binari, és a dir es donarà un argument -kb al cvs import.

Usa la data de modificació del fitxer com a data d'importació

Si marqueu aquesta casella, la data de la importació serà la de modificació del fitxer en lloc de la data d'importació.

Una vegada hàgiu emplenat aquest formulari i ho hàgiu confirmat prement D'acord, s'utilitzarà la següent ordre de CVS:

cvs -d repositori import -m "❷" mòdul etiqueta_distribuïdor etiqueta_llançament