Repositoris

Afegir repositori Github (clone)

Per a accedir a un repositori ofert pel professor, seguir els següents passos:

1. Des de la perspectiva "Git", a la vista "Git Repositories", cliqueu "Clone a Git repository".
2. A la pantalla "Source Git Repository", omplir "URI"amb la URL proporcionada pel professor. User/Password queden buits, ja que només llegirem (no escrivirem). Clicar "Next >".
3. A la pantalla "Branch Selection", seleccionar "master *" i clica "Next > ".
4. A la pantalla "Local Destination" podeu deixar el valor que apareix per defecte, o canviar-lo. Podeu deshabilitar "Import all existing Eclipse projects after clone finishes". Compte: si utilitzeu un disc extern, recordeu-vos de seleccionar també aquest disc.
5. A la vista "Git Repositories" tindreu el nou repositori. Feu clic dret sobre el nom i feu Ïmport Projects".
6. A la pantalla "Import projects from File System or Archive" veureu una llista de projectes que hi ha al repositori. Seleccioneu només els que estigueu interessats, i que tinguin a la columna "Import as" el valor "Eclipse project".

Refrescar repositori Github (pull)

Quan el professor canviï els continguts del repositori, podràs descarregar-los al teu projecte d'Eclipse:

1. A la vista "Project Explorer" feu clic dret al projecte i seleccioneu Team > Pull.
2. Us apareixerà una finestra amb el resultat. Si no hi ha canvis, "everything up to date". Si sí, informació de les novetats.

Si s'ha fet alguna modificació local, apareixerà una finestra "Problem Ocurred" amb el missatge "Checkout conflict with files". Pots anar a la vista "History" de Git mentre selecciones l'arxiu, seleccionar una versió a recuperar i clicar sobre l'arxiu per fer "Check out this version". O bé anar a la vista "Git Staging" i fer "Replace with HEAD version". O bé des del context del Package Explorer, fer "Replace with... > HEAD revision" (Discard Changes).

Crear un repositori i fer Push

1. Un cop tens un projecte, fes "Team" > "Share Project" i crea un repositori local nou, o selecciona un que vulguis compartir.
2. Afegeix els arxius que vulguis al projecte i fes "Commit".
3. Fes "Push branch master" i enganxa la URL d'un repositori de Github buit que hagis creat prèviament.
4. Clica "Push".

Branch & Pull request (Merge)

Si es vol treballar amb el workflow de Github, comença per fer un commit local i llavors crea una branca (branch):

1. Selecciona "Check out a ref or work with branches"
2. Selecciona la branca origen, normalment "master".
3. Clica "New Branch..."
4. Selecciona un nom, "branca1", i clica "Finish".

Ja tens una nova branca local. Fent "Check out" sobre la branca (doble clic) pots canviar la teva branca activa.

Des de la nova branca, ara pots fer canvis i commits. Finalment, voldràs pujar els canvis en remot.

1. Fes "Push to branch in remote".
2. Canvia el nom de la branca per defecte, que dirà "HEAD", al nom desitjat. Per example, el mateix que la local: "branca1".
3. Clica "Push".

Ara ja tens la branca en remot. Això serveix per compartir la teva feina, i que sigui validada pels teus companys de feina. Un cop validada, ja es podria fer un Merge.

1. Ves al portal github i busca la teva branca. Trobaràs un botó al seu costat anomenat "Compare & Pull request".
2. Afegeix un comentari, i clica "Create pull request".
3. Llavors "Merge pull request" i "Confirm merge". En aquest punt, opcionalment, es podria esborrar la branca, que ja no ens cal.
4. Ara podem fer "Check out" de la branca local "master", on no veurem els canvis.
5. Cal fer "Pull", i llavors tindrem els canvis remots (amb el Merge) al nostre repositori local.

Configuració

Font gran en Windows

Anar a Window > Preferences > General > Appearance > Colors and Fonts i modificar Basic > Text Font.

Per canviar la font de l'explorador, editar eclipse/plugins/org.eclipse.ui.themes_*/css/e4_default_win.css i afegir:

.MPart Tree {

    font-family: Consolas;

    font-size: XX;

}

Tipus d'arxiu text per defecte

Anar a Window > Preferences > General > Workspace : Text file encoding i seleccionar UTF-8.

JavaFX

Si utilitzes Java 8, necessites que Eclipse pugui accedir a una llibreria a sota de jre/lib/ext/jfxrt.jar. Per defecte, la carpeta ext no està disponible des del compilador d'Eclipse, ja que no es garanteix que existeixi a qualsevol distribució de la JVM.

Ves a Java Build Path > Libraries i expandeix JRE System Library. Accedeix a Access Rules > Edit i afegeix Resolution: Accessible, Rule Pattern: javafx/**.

Si utilitzes Java 11, aquí tens instruccions. Necessites fer això:

• Descarrega javafx 11 (també pots instal.lar-ho des de linux: openjfx)
• Ves a les propietats del projecte i fes Java Build Path > Libraries > Modulepath > Add Library... i afegeix una llibreria d'usuari que pots anomenar "javafx".
• A dins d'aquesta llibreria, afegeix els jars que s'han instal·lat prèviament. Per Windows, els pots trobar a C:\Program Files\OpenJFX.
• Quan executis l'aplicació, et cal afegir a "Run confingurations" els següents arguments:
  • --module-path="/path/on/son/els/jars" --add-modules=javafx.controls,javafx.fxml

Per instal·lar Scene Builder:

• https://www.oracle.com/java/technologies/javafxscenebuilder-1x-archive-downloads.html

Plugins

PlantUML

Plugin per Eclipse: http://plantuml.com/eclipse

Graphviz: https://graphviz.gitlab.io/_pages/Download/Download_windows.html