roa2web-service-auto/reports-app/frontend/scripts/README_ANDROID.md

📱 Android Testing Scripts

Scripturi pentru testarea aplicației ROA2WEB pe telefoane Android reale.

🎯 Scripturi Disponibile

Script	Platform	Status	Descriere
android-test-setup.ps1	Windows PowerShell	[OK] Functional	Setup complet Android testing
android-disconnect.sh	Bash/WSL	[OK] Functional	Cleanup port forwarding

---

Quick Start (Windows)

In Windows PowerShell:

cd E:\proiecte\roa2web\roa2web\reports-app\frontend\scripts

# Setup complet (prima data)
.\android-test-setup.ps1

Pentru cleanup:

# In WSL (dupa testare)
cd /mnt/e/proiecte/roa2web/roa2web/reports-app/frontend
./scripts/android-disconnect.sh

Screenshot-uri (Claude Code):

Nu mai este nevoie de script pentru salvare screenshot-uri! Claude Code poate face screenshot-uri direct prin MCP (chrome-devtools-android) si le primeste inline pentru analiza.

---

📜 Documentație Detaliată

1️⃣ android-test-setup.ps1 (Windows PowerShell)

Scop: Configurare completă conexiune Android pentru testare

Ce face:

• ✅ Verifică ADB este instalat
• ✅ Verifică telefon conectat (WiFi sau USB)
• ✅ Configurează port forwarding pentru Chrome DevTools (9222)
• ✅ Configurează reverse port forwarding pentru acces aplicație (3000, 8001)
• ✅ Testează conexiunea la Chrome pe telefon
• ✅ Afișează informații rețea și configurare MCP
• ✅ Comenzi utile pentru debugging

Utilizare:

cd E:\proiecte\roa2web\roa2web\reports-app\frontend\scripts
.\android-test-setup.ps1

Când să rulezi:

• Prima dată când conectezi telefonul
• După restart calculator/telefon
• Când port forwarding nu mai funcționează
• Pentru verificare setup

Output exemplu:

================================
🚀 ROA2WEB - Android Testing Setup
================================

✓ ADB este instalat
Android Debug Bridge version 1.0.41

✓ Telefon Android conectat: 1 dispozitiv(e)
10.0.20.114:38261       device

✓ Port forwarding configurat: localhost:9222 -> Chrome pe telefon
10.0.20.114:38261 tcp:9222 localabstract:chrome_devtools_remote

✓ Reverse port forwarding configurat
  Frontend: http://localhost:3000
  Backend:  http://localhost:8001/api

ℹ IP-ul calculatorului: 10.0.20.144

---

2 android-disconnect.sh (Bash/WSL)

Scop: Cleanup port forwarding când termini testarea

Ce face:

• ✅ Șterge toate port forwarding-urile (9222, 3000, 8001)
• ✅ Șterge reverse port forwarding
• ✅ Cleanup complet pentru deconectare sigură

Utilizare:

cd /mnt/e/proiecte/roa2web/roa2web/reports-app/frontend
./scripts/android-disconnect.sh

Când să rulezi:

• După finalizarea sesiunii de testare
• Înainte de a deconecta telefonul
• Pentru cleanup general

Output exemplu:

🔌 Deconectare telefon Android și cleanup...
✓ Port forwarding șters
✓ Reverse port forwarding șters
✅ Deconectare completă!

---

🔧 Workflow Complet de Testare

Setup Inițial (o dată):

1. Instalează ADB pe Windows:

winget install Google.PlatformTools

2. Configurează telefonul Android:

Setări → Despre telefon → Apasă 7x "Build number"
Setări → Developer options → Activează "USB debugging"
Setări → Developer options → Activează "Wireless debugging"

3. Conectează telefonul:

• WiFi: adb pair IP:PORT apoi adb connect IP:PORT
• USB: Conectează cablu, acceptă "Allow USB debugging"

Workflow Zilnic:

# Windows PowerShell

# 1. Setup conexiune
cd E:\proiecte\roa2web\roa2web\reports-app\frontend\scripts
.\android-test-setup.ps1

# 2. Pornește aplicația (în WSL)
cd /mnt/e/proiecte/roa2web/roa2web
./start-dev.sh

# 3. Pe telefon Chrome: http://localhost:3000

# 4. In Claude Code: "fa screenshot de pe telefon" (MCP inline)

# 5. La final, cleanup (WSL)
./scripts/android-disconnect.sh

---

🐛 Troubleshooting

"ADB not found"

winget install Google.PlatformTools
# Sau download manual: https://developer.android.com/tools/releases/platform-tools

"No Android device connected"

WiFi:

adb pair 10.0.20.114:PORT    # Portul din "Pair device"
adb connect 10.0.20.114:PORT # Portul wireless debugging
adb devices                   # Verifică

USB:

• Verifică cablul (unele sunt doar pentru încărcare)
• Deblochează telefonul
• Acceptă "Allow USB debugging"

"Port forwarding nu funcționează"

# Re-setup complet
.\android-test-setup.ps1

---

⚠️ Note Importante

De ce android-test-setup.sh nu funcționează în WSL?

ADB în WSL2 nu poate vedea dispozitivele USB conectate la Windows. Chiar și cu ADB wireless, există probleme de networking între WSL2 și Android device.

Soluție: Folosește scripturile PowerShell care rulează ADB direct în Windows!

Chrome DevTools MCP

Pentru ca Chrome DevTools MCP să funcționeze din WSL (Claude Code), trebuie:

1. Port forwarding activ: adb forward tcp:9222 ...
2. Windows port proxy: netsh interface portproxy add v4tov4 ...
3. Configurare MCP cu IP-ul fizic Windows: http://10.0.20.144:9222

Vezi tests/ANDROID_TESTING_GUIDE.md pentru setup complet.

---

📚 Documentație Suplimentară

• ANDROID_QUICK_START.md - Ghid rapid 5 minute
• tests/ANDROID_TESTING_GUIDE.md - Ghid complet cu troubleshooting
• frontend/README.md - Secțiunea "Testing on Real Android Devices"

---

Summary

Scripturi functionale:

• [OK] android-test-setup.ps1 (Windows PowerShell) - Setup complet
• [OK] android-disconnect.sh (WSL) - Cleanup

Screenshot-uri:

• Nu mai este nevoie de script dedicat
• Claude Code face screenshot-uri prin MCP (chrome-devtools-android) inline

Testare optima:

• Ruleaza android-test-setup.ps1 din Windows PowerShell
• Claude Code controleaza Chrome pe telefon prin MCP

---

Autor: ROA2WEB Development Team Data: 2025-10-20 Versiune: 3.0 (Final cleanup - doar scripturi esentiale)