# App Familia (Flutter)

##### Todos los repositorios se guardan en:

```
C:\\overskull\\

```

---

#### 🧩 **1. Versiones necesarias para este proyecto**

<table id="bkmrk-herramienta-versi%C3%B3n-"><thead><tr><th>Herramienta</th><th>Versión</th></tr></thead><tbody><tr><td>**Flutter**</td><td>3.29.3</td></tr><tr><td>**Dart**</td><td>3.3.x (incluido en Flutter 3.19.6)</td></tr><tr><td>**JDK**</td><td>Amazon Corretto 11</td></tr><tr><td>**Gradle**</td><td>Automático según Flutter</td></tr></tbody></table>

📌 **Leer este punto antes de continuar.**

Este proyecto **NO funciona** con Java 17 ni con Flutter global.

---

#### 🔽 **2. Descargar Flutter (versión obligatoria del proyecto)**

Descargar Flutter **3.19.6 (stable)** desde:

[https://docs.flutter.dev/release/archive](https://docs.flutter.dev/release/archive)

Guardar todas las versiones de Flutter en:

```
C:\\overskull\\SDK\\

```

Ejemplo:

```
C:\\overskull\\SDK\\flutter_windows_3.29.3-stable

```

📌 No usar Flutter global del sistema.

---

#### 🔧 **3. Instalar JDK 11 (Amazon Corretto)**

Descargar desde:

[https://docs.aws.amazon.com/corretto/latest/corretto-11-ug/downloads-list.html](https://docs.aws.amazon.com/corretto/latest/corretto-11-ug/downloads-list.html)

Guardar todas las versiones de Java en:

```
C:\\overskull\\java\\

```

Ejemplo:

```
C:\\overskull\\java\\amazon-corretto-11

```

---

#### 🚀 **4. Clonar el proyecto**

```bash
git clone git@storegit.overskull.com:shalom-over-app/shalom_familia.git
cd shalom_familia

```

---

#### 📁 **5. build.gradle (revisión inicial necesaria para arrancar el proyecto)**

Ruta:

```
C:\\overskull\\shalom_familia\\android\\app\\build.gradle

```

Ejemplo de referencia:

```bash
plugins {
    id "com.android.application"
    id "kotlin-android"
    id "dev.flutter.flutter-gradle-plugin"
}

def localProperties = new Properties()
def localPropertiesFile = rootProject.file('local.properties')
if (localPropertiesFile.exists()) {
    localPropertiesFile.withReader('UTF-8') { reader ->
        localProperties.load(reader)
    }
}

def flutterVersionCode = localProperties.getProperty('flutter.versionCode')
if (flutterVersionCode == null) {
    flutterVersionCode = '1'
}

def flutterVersionName = localProperties.getProperty('flutter.versionName')
if (flutterVersionName == null) {
    flutterVersionName = '1.0'
}

def keystoreProperties = new Properties()
def keystorePropertiesFile = rootProject.file('key.properties')
if (keystorePropertiesFile.exists()) {
    keystoreProperties.load(new FileInputStream(keystorePropertiesFile))
}

android {

    compileSdkVersion 31

    namespace "com.overskull.shalom.familia"
    compileSdkVersion flutter.compileSdkVersion
    //ndkVersion flutter.ndkVersion
    ndkVersion "25.2.9519653"
    compileOptions {
        sourceCompatibility JavaVersion.VERSION_1_8
        targetCompatibility JavaVersion.VERSION_1_8
    }

    kotlinOptions {
        jvmTarget = '1.8'
    }

    sourceSets {
        main.java.srcDirs += 'src/main/kotlin'
    }

    defaultConfig {
        // TODO: Specify your own unique Application ID (<https://developer.android.com/studio/build/application-id.html>).
        applicationId "com.overskull.shalom.familia"
        // You can update the following values to match your application needs.
        // For more information, see: <https://docs.flutter.dev/deployment/android#reviewing-the-gradle-build-configuration>.
        minSdkVersion 24
        targetSdkVersion 35
        versionCode 148
        versionName "1.4.8"
    }
    signingConfigs {
    release {
            keyAlias keystoreProperties['keyAlias']
            keyPassword keystoreProperties['keyPassword']
            storeFile keystoreProperties['storeFile'] ? file(keystoreProperties['storeFile']) : null
            storePassword keystoreProperties['storePassword']
        }
    }

    buildTypes {
        release {
            
            // TODO: Add your own signing config for the release build.
            // Signing with the debug keys for now, so `flutter run --release` works.
            signingConfig signingConfigs.release
        }
    }

    packagingOptions {
        jniLibs {
            useLegacyPackaging = false
        }
        doNotStrip "**/*.so"
    }
}

flutter {
    source '../..'
}

dependencies {}

```

📌 Si este archivo tiene errores, la app **no compila**.

---

#### ⚙️ **6. Configurar JDK en gradle.properties**

Editar:

```
C:\\overskull\\shalom_familia\\android\\gradle.properties

```

```
org.gradle.jvmargs=-Xmx4608m
android.useAndroidX=true
android.enableJetifier=true
org.gradle.java.home=C:/Program Files/Amazon Corretto/jdk11.0.29_7
android.enableAppCompileTimeRClass=true
android.bundle.enableUncompressedNativeLibs=false

```

---

#### 🧰 **7. Configurar la versión de Flutter usada por el proyecto**

```
C:\\overskull\\shalom_familia\\.vscode\\settings.json

```

```json
{
  "dart.flutterSdkPath": "C:/SDK/flutter_windows_3.19.6-stable"
}

```

---

#### ⚙️ **8. Configurar JDK en launch.json (VSCode)**

```
C:\\overskull\\shalom_familia\\.vscode\\launch.json

```

```json
{
  "version": "0.2.0",
  "configurations": [
    {
      "name": "Flutter Run Without Debug",
      "request": "launch",
      "type": "dart",
      "flutterMode": "debug",
      "noDebug": true,
      "program": "lib/main.dart",
      "env": {
        "JAVA_HOME": "C:/overskull/java/amazon-corretto-11"
      }
    }
  ]
}

```

---

#### 🐧 **9. Configuración adicional para Linux / multisistema**

```
android/gradle.properties

```

```
org.gradle.java.home=/home/usuario/java/amazon-corretto-11

```

---

#### 🧹 **10. Limpiar el proyecto**

```bash
cd android
./gradlew clean

```

---

#### 📦 **11. Descargar dependencias**

```bash
flutter pub get

```

---

#### 🛠️ **12. Modificaciones obligatorias**

**pubspec.yaml**

```
pdfx: ^2.6.0
flutter_slidable: ^3.1.2

```

**Archivo Términos y Condiciones**

Ruta:

```
C:\\overskull\\shalom_familia\\lib\\src\\Pages\\TerminosYCondiciones\\termino_View.dart

```

Cambiar:

❌

```dart
primary: Color.fromRGBO(107, 107, 107, 1),

```

✔️ por:

```dart
foregroundColor: Color.fromRGBO(107, 107, 107, 1),

```

📌 *Este cambio es obligatorio para compatibilidad con Flutter 3.19.6.*

---

#### 🎉 **13. Listo! Ahora puedes ejecutar el proyecto**

```bash
flutter run

```

##### 📌 **Notas importantes**

- Este proyecto usa **Java 11 (Amazon Corretto)**.
    
    ❌ No usar Java 17 ni versiones superiores.
- Verificar siempre que estas rutas coincidan:
    
    
    - `.vscode/settings.json` → versión correcta de Flutter
    - `android/gradle.properties` → ruta correcta del JDK
- El archivo `build.gradle` **no debe ser modificado** sin revisar compatibilidad con:
    
    
    - `compileSdkVersion`
    - `ndkVersion 25.2.9519653`
- La modificación en **Términos y Condiciones** es **obligatoria** para evitar errores de compilación en Flutter 3.19.6.
- Si el proyecto no compila a la primera:
    
    ```bash
    flutter clean
    flutter pub get
    
    ```