Preparació de l'entorn Joan Puigcerver Ibáñez j.puigcerveribanez@edu.gva.es Llicència: CC BY-NC-SA 4.0 (Reconeixement - NoComercial - CompartirIgual) 🅭 Objectius L'objectiu d'aquest material és configurar l'entorn de desenvolupament en ordinadors amb sistema operatiu Windows o distribucions de Linux basades en Debian, com Ubuntu o Linux Mint. 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. IntelliJ IDEA: Entorn de desenvolupament integrat. WSL: Subsistema de Linux per a Windows Git Git està disponible a https://git-scm.com/ per a Windows, macOS i Linux. UbuntuWindows sudo apt update sudo apt install git Descarrega i executa l'instal·lador de Git des de https://git-scm.com/ GitHub Si no en tens cap, crea't un compte a GitHub. Tasca Proporciona-li el teu usuari al docent la tasca corresponent en el curs del mòdul. Espera a ser convidat a l'organització fpmislata-dam2s-psp. Crea un repositori dins de l'organització: Propietari: fpmislata-dam2s-psp Nom del repositori: CognomNom-PSP Descripció: Repositori de les solucions del mòdul PSP en CIPFP Mislata del estudiant Nom Cognom Visibilitat: Privat NO afegir README ni LICENSE. Figura 1. Creació de repositori Si s'ha creat correctament, hauríeu de veure una pàgina com aquesta: Figura 2. Repositori remot buit Tasca Proporciona-li l'adreça HTTPS del teu repositori al docent del mòdul mitjançant la tasca corresponent en el curs del mòdul. Windows Subsystem for Linux (WSL) En aquest mòdul professional, treballarem els processos des del punt de vista de Linux. En cas d'utilitzar el sistema operatiu Windows, es pot instal·lar Windows Subsystem for Linux (WSL); un subsistema que possibilita la integració d'una distribució de Linux en Windows sense necessitat d'una màquina virtual. Per instal·lar-lo cal seguir les instruccions en la documentació: https://learn.microsoft.com/en-us/windows/wsl/install Bàsicament consisteix en executar la comanda des de PowerShell amb permisos d'administrador (botó dret, Run as administrator): wsl --install Una vegada instal·lat demana reiniciar l'ordinador. Fes-ho i executa la següent comanda. Aquesta operació iniciarà la instal·lació de la distribució Ubuntu. wsl --install -d Ubuntu També es recomana la instal·lació de la Windows Terminal des de la Microsoft Store. IntelliJ IDEA Descarrega i instal·la IntelliJ IDEA mitjançant l'instal·lador. Utilitzarem la versió Community de l'IDE. Inicia IntelliJ. Crea un nou projecte. Nom del projecte: CognomNom-PSP (el mateix que el repositori de GitHub) Seleccionar JDK: Oracle OpenJDK 22. Si no en tens cap instal·lat, donar-li a l'opció Download JDK... Utilitzar el build system Maven. No utilitzar cap plantilla. Advertència La interfície gràfica de IntelliJ ha canviat en les últimes versions. Figura 3. Creació de projecte a IntelliJ Una vegada creat, tindreu un projecte buit creat. Figura 4. Projecte creat a IntelliJ Comprova que el programa Main.java que ve per defecte s'executa. Una vegada comprovat, esborra el paquet org.example que s'ha creat per defecte. Crea el fitxer README.md a l'arrel del projecte amb el contingut: # CognomNom-PSP Repositori de les solucions del mòdul PSP en CIPFP Mislata del estudiant Nom Cognom Crea el package ud1.examples dins del directori src/main/java. Còpia l'exemple RunProcess dins del paquet ud1.examples i executa'l. Comprova que funciona. Figura 5. Execució de RunProcess Integració IntelliJ + GitHub Consell És possible que en les versions més recents de IntelliJ IDEA ja es cree el fitxer .gitignore amb les configuracions per defecte. Comproveu-ho. Copiar el contingut de .gitignore en un fitxer anomenat .gitignore en l'arrel del teu repositori. Afegir les línies: # Maven log/ target/ Figura 6. Fitxer .gitignore Activar la versió de control: VCS > Enable Version Control Integration i seleccionar Git Afegir el repositori de GitHub: Git > Manage Remotes... i donar-li al + Name: origin URL: L'enllaç del teu projecte de GitHub. Podeu triar el mètode d'autenticació: Clau SSH: Recomanada. Utilitza el protocol SSH. Personal Access Token (PAT): Utilitza el protocol HTTPS. Vegeu Mètodes d'autenticació a GitHub per a més informació. Figura 7. Afegir repositori remot Integració amb HTTPS Vos demanarà iniciar sessió, feu-ho mitjançant Use Token... Doneu-li a Generate... Se vos obrirà una pàgina de GitHub per generar el PAT token. Poseu la expiració: No expiration Genereu el token Copieu (i guardeu-vos) el token i introduïu-lo a IntelliJ. Integració amb SSH Crea una clau SSH: TerminalInterfície gràfica Executar la comanda ssh-keygen des del terminal. Obrir el programa Git GUI. Buscar el diàleg de generació de claus SSH en Help > Show SSH Key... > Generate key. Generar la clau amb el botó Generate Key. Còpia la clau pública generada al teu perfil de GitHub: Profile > Settings > SSH and GPG Keys > New SSH Key Commit inicial Realitzar un commit inicial: Git > Commit... Seleccionar tots els fitxers Missatge: Initial commit Botó: Commit Figura 8. Commit inicial Pujar el projecte a GitHub: Git > Push... Us hauria de sortir en verd els fitxers que aneu a pujar. Figura 9. Push a GitHub Verifiqueu que s'ha pujat a GitHub: Figura 10. Repositori 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. 📌 Aquest document pot quedar desactualitzat després d’imprimir-lo. Pots consultar la versió més recent a la pàgina web. 🌿 Abans d’imprimir aquest document, considera si és realment necessari. Redueix el consum de paper i ajuda a protegir el nostre entorn.

CC BY-NC-SA 4.0 (Reconeixement - NoComercial - CompartirIgual) 🅭 Joan Puigcerver Ibáñez