Child Timer 🦊⏱️
+Le temps devient visible, simplement.
+Un minuteur visuel Android conçu pour aider les enfants à comprendre le temps qui passe, sans chiffres au cadran ni compte à rebours numérique.
+
+ 
Le temps devient visible, simplement.
+Un minuteur visuel Android conçu pour aider les enfants à comprendre le temps qui passe, sans chiffres au cadran ni compte à rebours numérique.
+
+
+ 
+
AudioTrack et retour haptique via les API Android.
+
+## 🔧 Construire l'application
+
+### Prérequis
+
+Installe un JDK 17 et le SDK Android avec la plateforme Android API 36.
+
+### Compiler et tester
+
+Sur Linux ou macOS :
+
+~~~bash
+./gradlew testDebugUnitTest assembleDebug
+~~~
+
+Sur Windows :
+
+~~~bat
+gradlew.bat testDebugUnitTest assembleDebug
+~~~
+
+L'APK de débogage est généré dans :
+
+~~~text
+app/build/outputs/apk/debug/app-debug.apk
+~~~
+
+Pour produire la variante release non signée localement :
+
+~~~bash
+./gradlew assembleRelease
+~~~
+
+La variante release n'est pas installable tant qu'elle n'a pas été signée. La procédure de publication automatique est décrite ci-dessous.
+
+## 📦 Publier une release APK
+
+Le workflow GitHub Actions .github/workflows/release-apk.yml est conçu pour construire, signer et joindre l'APK à une **GitHub Release** lorsqu'un tag v* est poussé. Il nécessite une clé de signature privée, à conserver hors du dépôt.
+
+### 1. Créer une clé de signature
+
+Sur ta machine, exécute :
+
+~~~bash
+keytool -genkeypair -v -keystore child-timer-release.jks -alias child-timer -keyalg RSA -keysize 2048 -validity 10000
+~~~
+
+**Conserve précieusement ce fichier et ses mots de passe. Ne commite jamais la clé dans Git.** La même clé doit être réutilisée pour les prochaines versions afin de permettre les mises à jour de l'application.
+
+### 2. Ajouter les secrets GitHub
+
+Dans **Settings → Secrets and variables → Actions**, crée les secrets suivants :
+
+- ANDROID_KEYSTORE_BASE64 : contenu Base64 du fichier .jks.
+- ANDROID_KEY_ALIAS : alias utilisé à la création de la clé (ici child-timer).
+- ANDROID_KEYSTORE_PASSWORD : mot de passe du keystore.
+- ANDROID_KEY_PASSWORD : mot de passe de la clé.
+
+Sous Windows PowerShell, cette commande copie le contenu Base64 du keystore dans le presse-papiers :
+
+~~~powershell
+[Convert]::ToBase64String([IO.File]::ReadAllBytes(".\child-timer-release.jks")) | Set-Clipboard
+~~~
+
+Colle cette valeur uniquement dans le secret GitHub correspondant, jamais dans un fichier du dépôt.
+
+### 3. Déclencher la publication
+
+La version actuelle du projet indique versionName = "1.0". Après avoir vérifié la version et la configuration, crée puis pousse le tag correspondant :
+
+~~~bash
+git tag v1.0
+git push origin v1.0
+~~~
+
+Le workflow construit un APK release, le signe, vérifie sa signature puis crée une release avec l'APK en pièce jointe. Les prochaines versions devront augmenter versionCode et mettre à jour versionName dans app/build.gradle.kts avant de pousser leur tag.
+
+**Avant la toute première release publique**, vérifie également que l'identifiant Android applicationId = "com.aistudio.childtimer.kxrqzp" est bien celui que tu souhaites conserver. Le changer après la publication empêcherait l'APK suivant d'être reconnu comme une mise à jour de cette application.
+
+Les APK de téléchargement publiés seront disponibles dans les [GitHub Releases](https://github.com/aciderix/Child-timer/releases).
+
+## 🔒 Confidentialité
+
+Le manifeste Android ne déclare pas de permission réseau ; il déclare uniquement la permission de vibration. Les sons du timer sont synthétisés localement. L'application n'a pas besoin de compte utilisateur pour son fonctionnement actuel.
+
+## 🧭 Périmètre actuel
+
+Cette version est centrée sur le cadran animalier. Elle ne propose pas encore de compte à rebours chiffré, de pause/reprise, de préréglages de routines, de durée personnalisée ou d'historique. Le README décrit volontairement le fonctionnement de l'écran réellement lancé par l'application, et non les anciennes interfaces présentes dans le code source.
+
+## 📄 Licence
+
+Aucun fichier de licence n'est actuellement fourni dans le dépôt. Les conditions de réutilisation et de redistribution restent donc à définir.
From 5fb104475cc30037a0ad4fcc2d93813c3a5fb0c2 Mon Sep 17 00:00:00 2001
From: aciderix <121115002+aciderix@users.noreply.github.com>
Date: Tue, 27 Oct 2026 20:15:31 +0100
Subject: [PATCH 02/12] fix: use the default local debug signing configuration
---
app/build.gradle.kts | 18 ++++--------------
1 file changed, 4 insertions(+), 14 deletions(-)
diff --git a/app/build.gradle.kts b/app/build.gradle.kts
index bafb7be..247d498 100644
--- a/app/build.gradle.kts
+++ b/app/build.gradle.kts
@@ -15,19 +15,7 @@ android {
versionName = "1.0"
}
- signingConfigs {
- getByName("debug") {
- storeFile = file("${rootDir}/debug.keystore")
- storePassword = "android"
- keyAlias = "androiddebugkey"
- keyPassword = "android"
- }
- }
-
buildTypes {
- debug {
- signingConfig = signingConfigs.getByName("debug")
- }
release {
isMinifyEnabled = false
proguardFiles(getDefaultProguardFile("proguard-android-optimize.txt"), "proguard-rules.pro")
@@ -74,17 +62,19 @@ dependencies {
implementation(libs.androidx.compose.ui.tooling.preview)
implementation(libs.androidx.compose.material3)
implementation(libs.androidx.compose.material.icons.extended)
+
// Tooling
debugImplementation(libs.androidx.compose.ui.tooling)
+
// Instrumented tests
androidTestImplementation(libs.androidx.compose.ui.test.junit4)
debugImplementation(libs.androidx.compose.ui.test.manifest)
- // Local tests: jUnit, coroutines, Android runner
+ // Local tests
testImplementation(libs.junit)
testImplementation(libs.kotlinx.coroutines.test)
- // Instrumented tests: jUnit rules and runners
+ // Instrumented tests
androidTestImplementation(libs.androidx.test.core)
androidTestImplementation(libs.androidx.test.ext.junit)
androidTestImplementation(libs.androidx.test.runner)
From cc610c1eb068b758f3cb7f6136a5044e4c917dc4 Mon Sep 17 00:00:00 2001
From: aciderix <121115002+aciderix@users.noreply.github.com>
Date: Tue, 27 Oct 2026 20:15:34 +0100
Subject: [PATCH 03/12] chore: ignore local signing keys and built APKs
---
.gitignore | 8 ++++++++
1 file changed, 8 insertions(+)
diff --git a/.gitignore b/.gitignore
index aa724b7..fb91dc0 100644
--- a/.gitignore
+++ b/.gitignore
@@ -13,3 +13,11 @@
.externalNativeBuild
.cxx
local.properties
+
+# Local signing keys must never be committed.
+*.jks
+*.keystore
+*.p12
+
+# Build outputs are published through GitHub Releases instead.
+*.apk
From 998ce3092c3f2f68164b77cd20f892a70bc86ece Mon Sep 17 00:00:00 2001
From: aciderix <121115002+aciderix@users.noreply.github.com>
Date: Tue, 27 Oct 2026 20:15:54 +0100
Subject: [PATCH 04/12] ci: add Android build and unit-test workflow
---
.github/workflows/android-build.yml | 37 +++++++++++++++++++++++++++++
1 file changed, 37 insertions(+)
create mode 100644 .github/workflows/android-build.yml
diff --git a/.github/workflows/android-build.yml b/.github/workflows/android-build.yml
new file mode 100644
index 0000000..884f69b
--- /dev/null
+++ b/.github/workflows/android-build.yml
@@ -0,0 +1,37 @@
+name: Android build
+
+on:
+ push:
+ branches:
+ - main
+ pull_request:
+ workflow_dispatch:
+
+permissions:
+ contents: read
+
+jobs:
+ build:
+ name: Compile and test
+ runs-on: ubuntu-latest
+ steps:
+ - name: Check out repository
+ uses: actions/checkout@v7
+
+ - name: Set up JDK 17
+ uses: actions/setup-java@v6
+ with:
+ distribution: temurin
+ java-version: "17"
+ cache: gradle
+
+ - name: Set up Android SDK
+ uses: android-actions/setup-android@v4
+
+ - name: Install Android API 36 build tools
+ run: sdkmanager "platforms;android-36" "build-tools;36.0.0"
+
+ - name: Compile debug and release APKs and run unit tests
+ run: |
+ chmod +x gradlew
+ ./gradlew --no-daemon testDebugUnitTest assembleDebug assembleRelease
From 36d247b9ab42d5a300e985232f4c594c0a9b9f14 Mon Sep 17 00:00:00 2001
From: aciderix <121115002+aciderix@users.noreply.github.com>
Date: Tue, 27 Oct 2026 20:15:56 +0100
Subject: [PATCH 05/12] ci: automate signed APK GitHub releases
---
.github/workflows/release-apk.yml | 83 +++++++++++++++++++++++++++++++
1 file changed, 83 insertions(+)
create mode 100644 .github/workflows/release-apk.yml
diff --git a/.github/workflows/release-apk.yml b/.github/workflows/release-apk.yml
new file mode 100644
index 0000000..60bfe6b
--- /dev/null
+++ b/.github/workflows/release-apk.yml
@@ -0,0 +1,83 @@
+name: Build and publish Android APK
+
+on:
+ push:
+ tags:
+ - "v*"
+
+permissions:
+ contents: write
+
+jobs:
+ release:
+ name: Build, sign and publish APK
+ runs-on: ubuntu-latest
+ steps:
+ - name: Check out tagged source
+ uses: actions/checkout@v7
+
+ - name: Set up JDK 17
+ uses: actions/setup-java@v6
+ with:
+ distribution: temurin
+ java-version: "17"
+ cache: gradle
+
+ - name: Set up Android SDK
+ uses: android-actions/setup-android@v4
+
+ - name: Install Android API 36 build tools
+ run: sdkmanager "platforms;android-36" "build-tools;36.0.0"
+
+ - name: Validate signing secrets and decode keystore
+ env:
+ ANDROID_KEYSTORE_BASE64: ${{ secrets.ANDROID_KEYSTORE_BASE64 }}
+ ANDROID_KEY_ALIAS: ${{ secrets.ANDROID_KEY_ALIAS }}
+ ANDROID_KEYSTORE_PASSWORD: ${{ secrets.ANDROID_KEYSTORE_PASSWORD }}
+ ANDROID_KEY_PASSWORD: ${{ secrets.ANDROID_KEY_PASSWORD }}
+ run: |
+ test -n "$ANDROID_KEYSTORE_BASE64" || { echo "::error::Missing secret ANDROID_KEYSTORE_BASE64"; exit 1; }
+ test -n "$ANDROID_KEY_ALIAS" || { echo "::error::Missing secret ANDROID_KEY_ALIAS"; exit 1; }
+ test -n "$ANDROID_KEYSTORE_PASSWORD" || { echo "::error::Missing secret ANDROID_KEYSTORE_PASSWORD"; exit 1; }
+ test -n "$ANDROID_KEY_PASSWORD" || { echo "::error::Missing secret ANDROID_KEY_PASSWORD"; exit 1; }
+ printf '%s' "$ANDROID_KEYSTORE_BASE64" | base64 --decode > "$RUNNER_TEMP/child-timer-release.jks"
+ test -s "$RUNNER_TEMP/child-timer-release.jks"
+ echo "ANDROID_SIGNING_KEYSTORE=$RUNNER_TEMP/child-timer-release.jks" >> "$GITHUB_ENV"
+
+ - name: Build release variant
+ run: |
+ chmod +x gradlew
+ ./gradlew --no-daemon assembleRelease
+
+ - name: Sign and verify APK
+ env:
+ ANDROID_KEY_ALIAS: ${{ secrets.ANDROID_KEY_ALIAS }}
+ ANDROID_KEYSTORE_PASSWORD: ${{ secrets.ANDROID_KEYSTORE_PASSWORD }}
+ ANDROID_KEY_PASSWORD: ${{ secrets.ANDROID_KEY_PASSWORD }}
+ run: |
+ UNSIGNED_APK="app/build/outputs/apk/release/app-release-unsigned.apk"
+ test -f "$UNSIGNED_APK" || { echo "::error::Unsigned release APK not found at $UNSIGNED_APK"; exit 1; }
+
+ SDK_ROOT="${ANDROID_SDK_ROOT:-$ANDROID_HOME}"
+ APKSIGNER="$SDK_ROOT/build-tools/36.0.0/apksigner"
+ test -x "$APKSIGNER" || { echo "::error::apksigner not found at $APKSIGNER"; exit 1; }
+
+ SIGNED_APK="ChildTimer-${GITHUB_REF_NAME}.apk"
+ "$APKSIGNER" sign \
+ --ks "$ANDROID_SIGNING_KEYSTORE" \
+ --ks-key-alias "$ANDROID_KEY_ALIAS" \
+ --ks-pass "env:ANDROID_KEYSTORE_PASSWORD" \
+ --key-pass "env:ANDROID_KEY_PASSWORD" \
+ --out "$SIGNED_APK" \
+ "$UNSIGNED_APK"
+ "$APKSIGNER" verify --verbose "$SIGNED_APK"
+ echo "SIGNED_APK=$SIGNED_APK" >> "$GITHUB_ENV"
+
+ - name: Publish GitHub Release
+ env:
+ GH_TOKEN: ${{ github.token }}
+ run: |
+ gh release create "$GITHUB_REF_NAME" "$SIGNED_APK" \
+ --title "Child Timer $GITHUB_REF_NAME" \
+ --generate-notes \
+ --verify-tag
From 8edbf2c97271942c4cd2b64eb3346412f4272bb0 Mon Sep 17 00:00:00 2001
From: aciderix <121115002+aciderix@users.noreply.github.com>
Date: Tue, 27 Oct 2026 20:15:58 +0100
Subject: [PATCH 06/12] docs: reserve a folder for the app screenshot
---
docs/screenshots/README.md | 1 +
1 file changed, 1 insertion(+)
create mode 100644 docs/screenshots/README.md
diff --git a/docs/screenshots/README.md b/docs/screenshots/README.md
new file mode 100644
index 0000000..556fc3c
--- /dev/null
+++ b/docs/screenshots/README.md
@@ -0,0 +1 @@
+Dépose ici la capture d’écran du cadran, en mode paysage, sous le nom main-screen.png. Le README racine l’affichera automatiquement.
\ No newline at end of file
From 232a899dd20cbbffa361c6ef7147f9684f0ed98d Mon Sep 17 00:00:00 2001
From: aciderix <121115002+aciderix@users.noreply.github.com>
Date: Tue, 27 Oct 2026 20:16:19 +0100
Subject: [PATCH 07/12] chore: ignore Android build outputs and signing keys
---
.gitignore | 4 +++-
1 file changed, 3 insertions(+), 1 deletion(-)
diff --git a/.gitignore b/.gitignore
index fb91dc0..39a0289 100644
--- a/.gitignore
+++ b/.gitignore
@@ -5,10 +5,12 @@
/.idea/libraries
/.idea/modules.xml
/.idea/workspace.xml
-/.idea/navEditor.xml
+/.idea/navEditorSettings.xml
/.idea/assetWizardSettings.xml
.DS_Store
/build
+**/build/
+.captures
/captures
.externalNativeBuild
.cxx
From 21559e916508e8c1d794712d4684ddcbbe58d7f6 Mon Sep 17 00:00:00 2001
From: aciderix <121115002+aciderix@users.noreply.github.com>
Date: Tue, 27 Oct 2026 20:16:24 +0100
Subject: [PATCH 08/12] chore: correct Android build ignore patterns
---
.gitignore | 3 +--
1 file changed, 1 insertion(+), 2 deletions(-)
diff --git a/.gitignore b/.gitignore
index 39a0289..e307f95 100644
--- a/.gitignore
+++ b/.gitignore
@@ -5,12 +5,11 @@
/.idea/libraries
/.idea/modules.xml
/.idea/workspace.xml
-/.idea/navEditorSettings.xml
+/.idea/navEditor.xml
/.idea/assetWizardSettings.xml
.DS_Store
/build
**/build/
-.captures
/captures
.externalNativeBuild
.cxx
From 5e3232525c01f1c94f99c356eaafbbd5c52bfad1 Mon Sep 17 00:00:00 2001
From: aciderix <121115002+aciderix@users.noreply.github.com>
Date: Tue, 27 Oct 2026 20:20:12 +0100
Subject: [PATCH 09/12] Add files via upload
---
docs/screenshots/main-screen.png | Bin 0 -> 359156 bytes
1 file changed, 0 insertions(+), 0 deletions(-)
create mode 100644 docs/screenshots/main-screen.png
diff --git a/docs/screenshots/main-screen.png b/docs/screenshots/main-screen.png
new file mode 100644
index 0000000000000000000000000000000000000000..33bfe18b5b4967c3a57fb0e56d1605eba928ef51
GIT binary patch
literal 359156
zcmeFZWmH_j)+pE{1R{_G4<6jzJ;9sC8h3&;($EmxAql~~aS!fJ;}RSicZcA?Ew~N2
zci#QJZ{B;e)~q*g&HT8#t4{AzwQF0|>2qpV^?8_iSV57La