MPLAB-X #1 :: Subversion per progetti ASM

Se vogliamo utilizzare un repository SVN per i nostri progetti ASM su MPLAB-X possiamo farlo agganciando l'IDE di casa Microchip ad un client SVN installato sulla nostra macchina di sviluppo.
Darò per scontato che chi legge ha già dimestichezza con Subversion...

Seguendo passo passo questo articolo eviterete alcune "trappole" con MPLAB-X; bisogna infatti prestare attenzione a:

1. installare un client SVN compatibile con MPLAB-X
2. sapere quali file vanno condivisi e quali assolutamente no

Procediamo quindi con i seguenti passi (testati su MPALAB-X versione 1.95 in inglese):

1. scaricare e installare un SVN client versione 1.6.x
2. configurare il path al client SVN su MPLAB-X
3. importare un progetto ASM sul repository SVN
4. impostare il progetto per ignorare i file autogenerati nelle future commit

1) scaricare e installare un svn client versione 1.6.x

Consiglio di scaricare e installare questa versione da me testata con successo:
http://sourceforge.net/projects/win32svn/files/1.6.23/Setup-Subversion-1.6.23.msi

(se possibile scegliete come cartella di installazione 'C:\Subversion' evitando path con spazi)

Attenzione: se nel sistema avete già installato una versione di Subversion diversa dalla 1.6 e non vi è possibile effettuare l'upgrade o il downgrade allora scaricate questa distribuzione in formato zip:
http://sourceforge.net/projects/win32svn/files/1.6.23/svn-win32-1.6.23.zip/download

Scompattate lo zip in C:\Subversion1.6.23 e puntate MPLAB-X a questa.

2) configurare il path al client SVN su MPLAB-X

1. cliccare sul menu Tools > Options > TAB Miscellaneous > TAB Versioning
2. nella colonna a sinistra 'Versioning Systems' selezionare 'Subversion'
3. cliccare sul tasto 'Browse' e selezionare la cartella 'bin' presente nella cartella dove avete scelto di installare il client SVN (se avete seguito il mio consiglio il path sarà 'C:\Subversion\bin')
4. cliccare sul tasto 'OK' 

3) importare un progetto ASM sul repository SVN

1. assicurarsi di aver selezionato la TAB Projects in modo di avere la vista progetto
2. cliccare col destro sul nome del progetto e nel menu contestuale scendere in basso e aprire il sotto menu 'Versioning' cliccando poi su 'Import into Subversion Repository'
3. nella finestra che si apre impostare la URL al vostro repository SVN, la username e la password (vi consiglio di spuntare il salvataggio della password)
4. cliccare sul tasto 'Next' e nella schermata successiva inserire il commento (es: initial import) lasciando il resto a default
5. cliccando ancora sul tasto 'Next' nella finestra successiva apparirà la lista dei file da committare sul repository SVN
6. eliminate la spunta dai file Makefile-* e Package-* in quanto questi non vanno mai condivisi perchè sono autogenerati da MPLAB-X (vedi immagine 3.1) e cambiano da ambiente ad ambiente (conflitti sicuri)
7. cliccare sul tasto 'Finish'

Immagine 3.1: i file autogenerati da MPLAB-X non vanno mai condivisi

4) impostare il progetto per ignorare i file autogenerati nelle future commit

1. assicurarsi di aver selezionato la TAB Files in modo di avere la vista a file del progetto
2. cliccare con destro sulla cartella 'nbproject' e nel menu contestuale portarsi in basso su 'Subversion' e nel sotto menu cliccare su 'Svn Properties'
3. nella finestra 'Svn Properties Editor' che si è aperta fare doppio click in basso sul nome della proprietà 'svn:ignore' in modo da editarla
4. in alto adesso vediamo che la proprietà 'svn:ignore' ha già assegnato il valore 'private': questo indica che la cartella 'private' è già stata impostata da MPLAB-X come da ignorare
5. aggiungiamo sotto a 'private':
    Makefile*
   Package*
6. verificate che il campo 'Property Value' si presenti adesso come sotto (immagine 4.1)
7. cliccare sul tasto 'Update' e poi sul tasto 'Close'
8. fare la commit del progetto su SVN

Immagine 4.1: editare la property svn:ignore

Adesso possiamo lavorare con SVN in modo agevole su MPLAB-X.

Stay tuned!
ap

NB: l'autore non risponde di eventuali danni causati da omissioni, inesattezze o errori eventualmente presenti nell'articolo pubblicato.
Prego, segnalare suggerimenti e migliorie commentando questo post o inviando una email a padnest@gmail.com.