TUTORIAL

USANDOGOOGLECODECONNETBEANS

Yann Arthur Nicolas Julio 2007

INTRODUCCIN Cuandosequierecrearunsoftwaredemaneracooperativaocuandosequierequesteseaaccesiblea cualquiercuriosoquenavegueenInternetsepuedeoptarporcrearunsitioounblogparaelproyecto.Sin embargostonosobligaatenerqueagregarmanualmenteherramientasindispensablesanuestrositio comounwiki,unareadedescargas,...Ademssisequiereutilizarunsistemadecontroldeversiones querequieredeunsoftwareespecificoenelservidor,sonpocolosserviciosdehostingquelopermiten. GoogleCodeesunserviciogratuitoproporcionadoporGooglequepermitedemanerarelativamentefcil tenerunconjuntodeserviciosmuytilesparatodoproyectodedesarrollo. Unadesusventajassobreotrossitiodetiposourceforge.netuotroesquenoserequieredeninguna justificacinotiempodeesperaparaquenosautoricenelproyecto. Incluye: descargas wiki gestindeproblemas(issues) fuentesconaccesoaSubversion PorotroladoNetBeanseshoyunodelosprincipalesentornosintegralesdedesarrolloparaJava(aunque tambinsepuedeutilizarparaC/C++,Ruby,...)quetraenumerosasherramientasoutoftheboxpara crearprogramasdeescritorio,weboparatelfonosmviles. Essoftwarelibreporloqueestdisponibledeformagratuita.Suultimaversinesla6.0(actualmenteen beta)ytraebastantesmejorasrespectoala5.5. Subversinporsuparteesungestionadordeversionescentralizadoopensourcequevinoareemplazara CVS. Puede ser utilizado desde lnea de comandos pero clientes como NetBeans simplifican enormementesuuso.

OBJETIVOSDELTUTORIAL

DardealtaunproyectoenGoogleCode. CrearunproyectoenNetBeansysubirsusfuentesaGoogleCode. ConfigurarNetBeansparaaccederalasfuentesdeunrepositorioexistenteenGoogleCode.

PREREQUISITOS Pararealizarlaconfiguracinsenecesitatenerunosprogramasinstalados:

JDK6

DescargarlaultimaversindelJDK6osuperiordesdewww.java.sun.comodesdesu repositoriosiutilizaLinux. InstalarelJDK.

NetBeans6.0 DescargarlaultimaversindeNetBeans6.0desdewww.netbeans.org. InstalarNetBeans. Subversion DescargarlaultimaversindeSubversiondesdewww.subversion.tigris.orgodesdesu repositoriosiutilizaLinux. InstalarSubversion.

DARDEALTAUNPROYECTOENGOOGLECODE ParapodercrearunproyectoenGooglecodenecesitatenerunacuentaGmail.Sinodisponedeuna dirjaseawww.gmail.comyregstrese. Dirjasealsitiohttp://code.google.com/hosting/ SiestalogeadoconsucuentaGmail,verlasiguientepgina:

HagaclickenCreateanewproject Unformularioaparecerenpantallaconlossiguienteselementos:

ProjectName: Nombredelproyecto,debedesernicoporloquesiotrapersonayacreunproyectoconel mismonombreenGoogleCodeustednopodrusarlo.Debedeestarenminsculasysin smbolos. Summary: Resumendelproyecto,debesermuycortoperoexplcito. Description: Descripcinmsdetalladadelproyecto. Licence: Licenciadelproyecto.Alseraccesibleporcualquierpersona,seproponennicamentelicencias OpenSource. Labels: Sonpalabrasclavesquepermitirnaotraspersonasencontrarsuproyecto.

Nuestroproyectoquedadelasiguienteforma(tendrquecambiarloscamposparasuproyecto):

HacemosclicenelbotnCreateProjectyobtenemoslasiguientepantalla:

CREARUNPROYECTONETBEANS AbrimosNetBeans6yescogemosenelmenFile>NewProject. Nosaparecelasiguientepantalla:

EscogemosJavaenlacolumnaCategoriesyenseguidaJavaApplicationenlacolumnaProjects. PulsamosNextyaparecenvarioscamposparalaconfiguracindelproyecto.

Llenamos los campos como en la figura ( notese que la ubicacin de mi proyecto est en /home/yannart/NetBeansProjectspuedeespecificarsupropiaruta)debedeactivarlaopcinCreate MainClassparaqueNetBeansproporcioneautomticamenteunaclaseMain. PulsamosFinish.

Nuestroproyectodeberatenerunaestructuraparecidaaesta:

HacemosdobleclickenMain.javayreemplazamostodoeltextoporelsiguiente:
package testgooglecode; public class Main { /** * @param args the command line arguments */ public static void main(String[] args) { System.out.print("Hello World"); } }

EjecutamoselproyectopulsandoF6ynosaparecelosiguienteenlaventanaOutput(sepusoen negritaselresultadodelaejecucindelprograma):
init: deps-jar: Created dir: /home/yannart/NetBeansProjects/testGoogleCode/build/classes Compiling 1 source file to /home/yannart/NetBeansProjects/testGoogleCode/build/classes compile: run: Hello World BUILD SUCCESSFUL (total time: 2 seconds)

SUBIRELPROYECTOAGOOGLECODE Hacemosclicderechoenelnododelproyecto:

En el menqueaparecenoscolocamosenVersioningypulsamossobreImportintoSubversion Repository. DeregresoanuestroproyectoenGoogleCode,seleccionamoslapestaaSource:

LoquenosinteresaeselURLdenuestroproyecto: https://NOMBRE_PROYECTO.googlecode.com/svn/trunk/ dondeNOMBRE_PROYECTOeselnombredesuproyecto. Tambinnecesitamosunacontrasea(diferentealadesucuentadeGmail).

Para obtenerla hacemos clic en googlecode.com password en esta pagina o vamos a http://code.google.com/hosting/settings.Lacontraseaesdetipoy3h5w1i8. TeniendoestainformacinregresamosaNetBeansyllenamosloscamposdelcuadrodedialogo:

ProbablementesetendrquedesactivarelproxyactivadopordefectoporNetBeans: HacemosclicenProxyConfiguration...yenlaventanaqueapareceseleccionamoslaopcionno proxyypulsamosOK.

DeregresoalaventanaanteriorpulsamosNext.Sitodoandabien,NetBeansseconectaalSubversion enGoogleCodeysedespliegaenpantallalasiguienteventana:

EspecificamosunmensajeenelcuadroSpecifytheMessageypulsamosFinish. VeremosaparecerdosnuevaspestaasenelOutputquemuestranlaactividaddeSubversion:

AhoraprobaremoshacerunasmodificacionesalcdigodelaclaseMain: Reemplacemoselcdigoporelsiguiente:
package testgooglecode; public class Main { /** * @param args the command line arguments */ public static void main(String[] args) { Main main = new Main(); main.printMessage(Language.ENGLISH); main.printMessage(Language.ESPANOL); main.printMessage(Language.FRANCAIS); } void printMessage(Language language) { String message = null; switch (language) { case FRANCAIS: message = "Bonjour le monde";

break; case ESPANOL: message = "Hola Mundo"; break; default: message = "Hello World"; } } System.out.println(message);

enum Language { ENGLISH, FRANCAIS, ESPANOL } }

EjecutamoselproyectopulsandoF6ynosaparecelosiguienteenlaventanaOutput(sepusoen negritaselresultadodelaejecucindelprograma):
init: deps-jar: Deleted 3 out of date files in 0 seconds Compiling 1 source file to /home/yannart/NetBeansProjects/testGoogleCode/build/classes compile: run: Hello World Hola Mundo Bonjour le monde BUILD SUCCESSFUL (total time: 0 seconds)

AlusarSubversionhayquetenerpresentequelasmodificacionessehacensobreunacopialocaldel cdigoyquestesemandaalservidorcuandohacemosunCommit.Delamismamanera,siqueremos actualizarnuestracopialocalconlasfuentesmsrecientesdisponiblesenelrepositoriodeberemosde hacerunUpdate.AmbasfuncionesestndisponiblesenNetBeansatravsdelmenSubversional quepuedeaccederhaciendounclicderechoalnododelproyecto:

OtraherramientamuyutilesDiffquepermiteverladiferenciaentravariasversionesdelafuentes. Hagaclicderechoenelnododelproyecto,luegoseleccioneSubversionypulseDiff.

Seabrirunaventanacomoesta:

Delladoizquierdovemoslaversinqueestenelrepositorioydelladovemoslaversinlocal. Enazulsepintanlasseccionesmodificadas,enverdelasnuevasyenrojolasborradas.Notesequeestos colorestambinestnpresenteseneleditorypermitencancelarlasmodificacionesquehemoshecho. Sihicieramosuncommitestaherramientayomostraraningunadiferenciayaquetendramoslamisma versintantolocalmentecomoenelservidor. Sinembargotambinesposibleverdiferenciasentreversionespasadas,paraestoutilizamoslaopcin SearchHistory...delmismomendeSubversion.Losdejoexperimentarconeso. Antesdeterminarhagamosesecommit:

ACCEDERAUNREPOSITORIOEXISTENTE SupongamosqueunrepositorioyaexisteenGoogleCodeoqueporejemploustedcreounoyquiereque otrapersonaloaccededesdeNetbeans.Nadamassencillo. Cerremoselproyectoanterior(brrelosiquiere). EnelmenudeNetBeansseleccionamosVersioning>SubversionypulsamosCheckout...:

Llenaremosloscamposdemanerasimilaracomolohicimosanteriormente(noteseel/trunk):

PulsamosNext(noolvideconfigurarelproxy)ysenosmuestraunaventanadeestetipo:

Solocambiamoslaubicacin(LocalFolder)dondequeremosqueseguardenlocalmentelosarchivos. PulsamosFinishyNetBeansvaabajarlosarchivosdelrepositorioylosvaacopiarlocalmente.

ComoNetBeansdetectaquelosarchivosdescargadosrepresentanunproyectoNetBeans,preguntasi queremosabrirlo. PulsamosOpenProjectyestamoslistosparatrabajar. Nota:GoogleCodetambinproporcionaunURLalrepositorioparaelcualnosenecesitaidentificarse. Sinembargolaspersonasqueloutilicensibienpodrnobtenerunacopiadelproyecto,nopodrnhacer commits.

CONCLUSION Vimoslosimpleyrpidoqueescrearunproyecto,subirloaGoogleCode,hacercommits,updatesy verlasdiferenciasentrelasdiferentesversionesdelasfuentes. Tambinvimoscomoaccederaunproyectoexistenteobteniendoensegundosunacopialocal. Al tener las fuentes de un proyecto centralizadas, el desarrollo colaborativo se vuelve mucho mas ordenado,practicoyseguro.Yenelcasodetrabajarsolotenemosadisposicinunamaquinadel tiempoparapoderrevertirmodificacionesoverlaprogresindenuestroproyecto.

AUTOR YannArthurNicolas yannart@gmail.com http://merlinsource.blogspot.com/ www.merlinsource.com