AudiOhm/archives/docs/BUILD_STATUS.md

# 🎵 AudiOhm - Build Status & Instructions

**Date:** 2026-01-19
**Status:** Configuration terminée, prête à builder

---

## 📊 Résumé

| Plateforme | Configuration | Build | Status |
|-----------|--------------|-------|--------|
| **Android** | ✅ Terminée | ⚠️ Nécessite Android SDK | Prêt à builder |
| **Windows** | ✅ Terminée | ❌ Requiert Windows host | Prêt à builder |
| **Web** | ✅ Terminée | ❌ just_audio_web incompatible | Alternative nécessaire |
| **Linux** | ⚠️ Non configurée | ❌ Non supportée par défaut | N/A |

---

## ✅ Ce qui a été fait

### 1. Flutter Installation
- ✅ Flutter 3.38.7 installé dans `/opt/flutter/`
- ✅ Dart 3.10.7 configuré
- ✅ Dépendances installées (185 packages)
- ✅ Package `equatable` ajouté

### 2. Correction Imports
- ✅ Import `colors.dart` corrigé dans `skeleton_loading.dart`
- ✅ Import `colors.dart` corrigé dans `cached_network_image_with_fallback.dart`
- ✅ Import `auth_provider.dart` corrigé dans `api_service.dart`
- ✅ Correction API Dio pour token refresh

### 3. Configuration Android
- ✅ `android/build.gradle` créé (Gradle 8.1.0, Kotlin 1.9.0)
- ✅ `android/app/build.gradle` créé
- ✅ `AndroidManifest.xml` configuré avec permissions
- ✅ Icônes launcher cyberpunk néon créées
- ✅ `network_security_config.xml` ajouté
- ✅ Package: `com.audiohm.audiOhm`

### 4. Configuration Windows
- ✅ Structure Windows créée
- ✅ `runner_config.json` configuré
- ✅ Nom de l'exe: `audiOhm.exe`

### 5. Scripts & Documentation
- ✅ `BUILD.sh` - Script de build automatisé
- ✅ `BUILDS.md` - Documentation complète
- ✅ `BUILD_INSTRUCTIONS.md` - Instructions détaillées
- ✅ `START_GUIDE.md` - Guide de démarrage rapide

---

## ⚠️ Problèmes Connus

### 1. Android Build - Android SDK Manquant

**Erreur:**
```
[!] No Android SDK found. Try setting the ANDROID_HOME environment variable.
```

**Solution:**
Installer Android SDK:

```bash
# Option 1: Android Studio (Recommandé)
wget https://redirector.gvt1.com/edgedl/android/studio/ide-zips/2023.1.1.28/android-studio-2023.1.1.28-linux.tar.gz
tar -xzf android-studio-*.tar.gz
./android-studio/bin/studio.sh

# Option 2: Command-line tools
mkdir -p ~/Android/sdk
cd ~/Android/sdk
wget https://dl.google.com/android/repository/commandlinetools-linux-9477386_latest.zip
unzip commandlinetools-*.zip
export ANDROID_HOME=~/Android/sdk
export PATH=$PATH:$ANDROID_HOME/cmdline-tools/latest/bin
```

Puis accepter les licenses:
```bash
flutter doctor --android-licenses
```

### 2. Windows Build - Cross-compilation

**Erreur:**
```
"build windows" only supported on Windows hosts.
```

**Solution:**
Le build Windows DOIT être effectué sur une machine Windows. Transférez simplement le code sur Windows et:

```powershell
cd frontend
flutter build windows --release
```

### 3. Web Build - just_audio_web Incompatible

**Erreur:**
```
Error: Function converted via 'toJS' contains invalid types in its function signature
```

**Cause:**
Le package `just_audio_web` 0.4.11 n'est pas compatible avec Flutter 3.38.7 et les nouveaux compilateurs Web.

**Solutions:**

#### Option 1: Utiliser une alternative web
```yaml
# pubspec.yaml
dependencies:
  # Pour mobile/desktop
  just_audio: ^0.9.44

  # Pour web - utiliser une alternative
  audioplayers: ^6.0.0
```

Puis utiliser des imports conditionnels:
```dart
import 'package:just_audio/just_audio.dart' // Mobile/Desktop
    if (dart.library.html) 'package:audioplayers/audioplayers.dart'; // Web
```

#### Option 2: Attendre une mise à jour de just_audio_web
```bash
flutter pub upgrade
# Si une nouvelle version est disponible, essayer:
flutter build web --release
```

#### Option 3: Build Web sans audio pour l'instant
Créer une version web sans streaming audio pour le développement UI/UX.

---

## 🚀 Comment Builder

### Android (Sur Linux/macOS/Windows avec Android SDK)

```bash
cd /opt/audiOhm/frontend

# Debug APK (Test rapide)
flutter build apk --debug

# Release APK
flutter build apk --release

# App Bundle (Play Store)
flutter build appbundle --release
```

**Output:**
- Debug: `build/app/outputs/flutter-apk/app-debug.apk`
- Release: `build/app/outputs/flutter-apk/app-release.apk`
- Bundle: `build/app/outputs/bundle/release/app-release.aab`

### Windows (Sur Windows uniquement)

```powershell
cd frontend

# Debug
flutter build windows --debug

# Release
flutter build windows --release
```

**Output:**
- Debug: `build/windows/runner/Debug/audiOhm.exe`
- Release: `build/windows/runner/Release/audiOhm.exe`

### Linux (Non configuré)

```bash
flutter build linux --release
```

**Note:** Linux desktop support n'est pas activé par défaut. Pour l'activer:
```bash
flutter config --enable-linux-desktop
```

---

## 📦 Alternatives de Déploiement

### Option 1: Web avec Audio Alternative

Utiliser un package audio compatible web:

```yaml
dependencies:
  audioplayers: ^6.0.0
  # ou
  assets_audio_player: ^3.0.5
```

### Option 2: Version Web UI-only

Pour démonstration du design sans audio:

```bash
flutter build web --release
# Déployer sur Netlify/Vercel/Cloudflare Pages
```

### Option 3: APK Android via CI/CD

Utiliser GitHub Actions ou GitLab CI avec Android SDK pré-configuré:

```yaml
# .github/workflows/android.yml
name: Build Android
on: [push]
jobs:
  build:
    runs-on: ubuntu-latest
    steps:
      - uses: actions/checkout@v3
      - uses: subosito/flutter-action@v2
      - run: flutter pub get
      - run: flutter build apk --release
      - uses: actions/upload-artifact@v3
        with:
          name: app-release
          path: frontend/build/app/outputs/flutter-apk/app-release.apk
```

---

## 🔧 Tests & Développement

### Web (Test rapide)

```bash
cd frontend
flutter run -d chrome
```

### Android (Test avec appareil)

```bash
# Connecter appareil
adb devices

# Run
flutter run -d <device_id>
```

### Desktop (Test local)

```bash
# Linux
flutter run -d linux

# Windows
flutter run -d windows
```

---

## 📝 Configuration Actuelle

### Android
- **Min SDK:** 21 (Android 5.0)
- **Target SDK:** 34 (Android 14)
- **Compile SDK:** 34
- **Kotlin:** 1.9.0
- **Gradle:** 8.1.0

### Application
- **Package:** com.audiohm.audiOhm
- **Version:** 0.1.0+1
- **Flutter:** 3.38.7
- **Dart:** 3.10.7

---

## 🎯 Prochaines Étapes

1. **Installer Android SDK** pour créer l'APK Android
2. **Transférer sur Windows** pour créer l'EXE Windows
3. **Résoudre compatibilité web** avec une alternative audio
4. **Tester sur appareils réels** après création des builds

---

## 📞 Support

### Problèmes Android

```bash
flutter doctor -v
flutter doctor --android-licenses
```

### Problèmes de build

```bash
cd frontend
flutter clean
flutter pub get
flutter build <platform>
```

### Vérifier les devices disponibles

```bash
flutter devices
```

---

## ✅ Checklist

- [x] Flutter installé
- [x] Dépendances installées
- [x] Configuration Android créée
- [x] Configuration Windows créée
- [x] Imports corrigés
- [ ] Android SDK installé
- [ ] APK Android buildé
- [ ] EXE Windows buildé (sur Windows)
- [ ] Version web fonctionnelle

---

**Version:** 1.0.0
**Date:** 2026-01-19
**Status:** Configuration terminée, prêt à builder (avec prérequis)