Integració Git amb IntelliJ Autor: Joan Puigcerver Ibáñez Correu electrònic: j.puigcerveribanez@edu.gva.es Llicència: CC BY-NC-SA 4.0 (Reconeixement - NoComercial - CompartirIgual) 🅭 Objectius Configurar l'entorn de desenvolupament per realitzar la integració del sistema de controls Git en projectes de desenvolupament. En aquest manual s'instal·larà i es configuraran les següent eines: Git: Eina de control de versions. GitHub: Emmagatzemament en línia de repositoris Git. Projecte d'IntelliJ IDEA Per començar, caldrà utilitzar el projecte de IntelliJ IDEA creat a Preparació de l'entorn. Git Cal instal·lar Git, si no està instal·lat. UbuntuWindows sudo apt update sudo apt install git Descarrega i executa l'instal·lador de Git des de https://git-scm.com/ Una vegada instal·lat, pots utilitzar la consola Git Bash. És una terminal basada l'intèrpret Bash, que et permetrà realitzar les comandes de Git en la consola. GitHub Si no en tens cap, crea't un compte a GitHub. Proporciona-li el teu usuari al docent del mòdul mitjançant la tasca corresponent en el curs del mòdul. Espera a ser convidat a l'organització: DAW1 DAM1S fpmislata-daw1-ed fpmislata-dam1s-ed Warning Aquest procés no és automàtic, per tant, heu de tindre paciència. Aniré convidant-vos a mesura que aneu proporcionant-me el vostre usuari de GitHub. Creació del repositori remot Crea un repositori dins de l'organització corresponent amb les següents característiques: Propietari: fpmislata-{grup}-ed Nom del repositori: CognomNom-ED Descripció: Repositori de les solucions del mòdul ED del grup {GRUP} en CIPFP Mislata del estudiant Nom Cognom Visibilitat: Privat NO afegir README ni LICENSE. Figura 1. Crear repositori a GitHub Si s'ha creat correctament, hauríeu de veure una pàgina com aquesta: Figura 2. Repositori buit a GitHub Integració IntelliJ + GitHub Autenticació Heu de configurar prèviament la vostra autenticació a GitHub. Recomanació Es recomana utilitzar l'autenticació mitjançant clau SSH. Clau SSH: Utilitza el protocol SSH. Personal Access Token (PAT): Utilitza el protocol HTTPS. Podeu consultar l'apartat Mètodes d'autenticació a GitHub per a més informació. Git Bash com a terminal IntelliJ IDEA permet configurar la terminal que utilitza per defecte i pot ser configurat per utilitzar Git Bash. A la configuració de l'IDE File > Settings > Tools > Terminal podem especificar la ruta de la terminal que volem utilitzar. En aquest cas, hem de trobar la carpeta on s'ha instal·lat Git i seleccionar l'executable bin/bash.exe. Figura 3. Configuració de la terminal a IntelliJ IDEA Una vegada ha segut configurada, ja podem utilitzar la terminal de Git Bash des de l'IDE. Figura 4. Terminal de Git Bash a IntelliJ IDEA Fitxers Important L'arrel del projecte es correspon amb la carpeta del projecte: CognomNom-ED/. En els següents passos, modificareu el contingut dels següents fitxers: CognomNom-ED/.gitignore CognomNom-ED/README.md Fixa't Fixa't si a l'arrel del projecte hi ha un fitxer .gitignore. Si no existeix, descarrega'l de GitHub i copia'l a l'arrel del teu projecte: .gitignore. Crea el fitxer README.md a l'arrel del projecte amb el contingut: # CognomNom-ED Respositori de les solucions del mòdul ED de {GRUP} en CIPFP Mislata del estudiant Nom Cognom Configuració de Git Podeu realitzar aquesta tasca des de la terminal o des de la interfície gràfica de IntelliJ IDEA. Activar la versió de control: VCS > Enable Version Control Integration i seleccionar Git Aquesta ordre equival a executar git init en la carpeta del projecte. Canvia el nom de la branca master per main: Git > Branches... > Selecciona la branca master > Botó dret > Rename... Aquesta ordre equival a executar git branch -m main en la carpeta del projecte. Figura 5. Canviar nom de la branca a IntelliJ IDEA Configurar el remot Afegeix el repositori de GitHub: Git > Manage Remotes... i donar-li al + Name: origin URL: L'enllaç del teu projecte de GitHub. Important Si has configurat la clau SSH, cal utilitzar l'enllaç SSH. Aquest pas és equivalent a executar git remote add origin URL en la carpeta del projecte. Figura 6. Afegir remot a IntelliJ IDEA Commit inicial Una vegada afegit el repositori remot, ja podem realitzar el primer commit. Realitzar un commit inicial: Git > Commit... Seleccionar tots els fitxers Missatge: Initial commit Botó: Commit Figura 7. Commit inicial a IntelliJ IDEA Pujar el projecte a GitHub: Git > Push... Us hauria d'eixir en verd els fitxers que aneu a pujar. Figura 8. Push a IntelliJ IDEA Verifiqueu que s'ha pujat a GitHub: Figura 9. Canvis publicats a GitHub Treballar amb Git Una vegada configurat l'espai de treball, ja es pot utilitzar per afegir noves classes i sincronitzar-les en diferents espais de treball mitjançant Git. Tot el codi estarà dins de la carpeta src. Quan es vulga sincronitzar el codi de IntelliJ IDEA a GitHub caldrà: Realitzar un pull per incorporar els canvis que hagen pogut haver i no crear conflictes: Git > Pull... Realitzar un commit amb els canvis: Git > Commit... Missatge del commit significatiu Realitzar un push: Git > Push Comprovar que s'ha actualitzat correctament en GitHub.

Comentaris