feat(android): rename APK to crossbar.apk and add Telegram caption support

- Configure applicationVariants.all in build.gradle.kts to generate crossbar.apk
- Update Makefile to use Gradle output path instead of flutter-apk folder
- Add CAPTION parameter for make android with tdl upload support
- Fix AndroidManifest.xml to use @string/app_name instead of hardcoded value
- Document CAPTION usage and syntax rules in AGENTS.md

Author: insign

AGENTS.md

@@ -210,6 +210,7 @@ Plugins usam a própria CLI do Crossbar para obter dados.
 | Testes (sem hardware)   | `flutter test --exclude-tags=hardware` (evita glitches locais)            |
 | Verificar Coverage      | Verificar se coverage está >= 43% (lcov --summary coverage/lcov.info)     |
 | Build Release (Linux)   | `make linux`                                                              |
+| Build Release (Android) | `make android` ou `make android CAPTION="- Feature 1\n- Fix 2"`           |
 | Analisar Código         | `flutter analyze --no-fatal-infos`                                        |
 | Monitorar CI            | `gh run watch`                                                            |
 | **Matar GUI + Reabrir** | `pkill -9 -f crossbar-gui; ./build/linux/x64/release/bundle/crossbar gui` |
@@ -236,6 +237,48 @@ Ou use o comando combinado:
 pkill -9 -f crossbar-gui; pkill -9 -f crossbar; flutter build linux --release && ./build/linux/x64/release/bundle/crossbar gui
 ```
 
+### 📱 Build Android com Upload para Telegram
+
+O comando `make android` gera `crossbar.apk` e faz upload via `tdl` (se instalado).
+
+**Uso básico** (sem legenda):
+```bash
+make android
+```
+
+**Com release notes** (use `\n` para quebras de linha):
+```bash
+make android CAPTION="- Corrigido bug X\n- Adicionada feature Y"
+```
+
+**⚠️ Regras importantes para CAPTION:**
+1. **Use `\n` para quebras de linha** - Não use quebras de linha reais no terminal
+2. **Evite caracteres especiais** - `•`, `→`, emojis podem causar erros de parsing
+3. **Use hífen `-` para listas** - Funciona melhor que bullets
+4. **Aspas simples dentro do texto** - Escape com `\'` ou evite
+
+**Exemplos corretos:**
+```bash
+# Lista simples
+make android CAPTION="- Feature 1\n- Feature 2\n- Bug fix"
+
+# Com descrição
+make android CAPTION="Release v1.5.0\n\n- Nova UI\n- Performance melhorada"
+```
+
+**Exemplos que causam erro:**
+```bash
+# ❌ Quebra de linha real (erro de sintaxe)
+make android CAPTION="- Feature 1
+- Feature 2"
+
+# ❌ Bullet point unicode (erro de parsing)
+make android CAPTION="• Feature 1"
+
+# ❌ Aspas não escapadas
+make android CAPTION="Versão "beta""
+```
+
 ---
 
 ## 9. Diretrizes de Desenvolvimento (Development Guidelines)

Makefile

@@ -141,11 +141,25 @@ windows:
 	dart compile exe bin/crossbar.dart -o $(WINDOWS_BUNDLE)/crossbar.exe
 	@echo "Done! Binaries at $(WINDOWS_BUNDLE)/"
 
-# Android build
+# Android build (APK name configured in android/app/build.gradle.kts)
+# Usage: make android CAPTION="Release notes here"
+# Caption supports HTML: <b>bold</b>, <i>italic</i>, <code>code</code>
+# Use \n for newlines in CAPTION
+CAPTION ?=
 android:
 	flutter build apk --release --target-platform android-arm64
-	@if command -v tdl >/dev/null 2>&1; then tdl up -t 6 --path=./build/app/outputs/flutter-apk/app-release.apk; fi
-	@echo "Done! APK at build/app/outputs/flutter-apk/app-release.apk"
+	@if command -v tdl >/dev/null 2>&1; then \
+		VERSION=$$(grep '^version:' pubspec.yaml | cut -d' ' -f2); \
+		if [ -n "$(CAPTION)" ]; then \
+			tdl up -t 6 -c 3305021517 --path=./build/app/outputs/apk/release/crossbar.apk \
+				--caption "\"<b>Crossbar v$$VERSION</b>\n\n$(CAPTION)\""; \
+		else \
+			tdl up -t 6 -c 3305021517 --path=./build/app/outputs/apk/release/crossbar.apk \
+				--caption "\"<b>Crossbar v$$VERSION</b>\""; \
+		fi; \
+	fi
+	@echo "Done! APK at build/app/outputs/apk/release/crossbar.apk"
+	@echo "Done! APK at build/app/outputs/apk/release/crossbar.apk"
 
 # Run tests
 test:
@@ -222,5 +236,3 @@ icons:
 	@echo "Generating launcher icons (Android, Windows, macOS)..."
 	dart run flutter_launcher_icons
 	@echo "Done! All icons generated."
-
-

android/app/build.gradle.kts

@@ -8,8 +8,8 @@ plugins {
     id("dev.flutter.flutter-gradle-plugin")
 }
 
-val keystoreProperties = Properties()
 val keystorePropertiesFile = rootProject.file("key.properties")
+val keystoreProperties = Properties()
 if (keystorePropertiesFile.exists()) {
     keystoreProperties.load(FileInputStream(keystorePropertiesFile))
 }
@@ -29,33 +29,29 @@ android {
         jvmTarget = JavaVersion.VERSION_17.toString()
     }
 
-    defaultConfig {
-        // TODO: Specify your own unique Application ID (https://developer.android.com/studio/build/application-id.html).
-        applicationId = "com.verseles.crossbar"
-        // You can update the following values to match your application needs.
-        // For more information, see: https://flutter.dev/to/review-gradle-config.
-        minSdk = 24
-        targetSdk = flutter.targetSdkVersion
-        versionCode = flutter.versionCode
-        versionName = flutter.versionName
-    }
-
     signingConfigs {
         create("release") {
             keyAlias = keystoreProperties["keyAlias"] as String?
             keyPassword = keystoreProperties["keyPassword"] as String?
-            storeFile = keystoreProperties["storeFile"]?.let { file(it) }
+            storeFile = keystoreProperties["storeFile"]?.let { file("$it") }
             storePassword = keystoreProperties["storePassword"] as String?
         }
     }
 
+    defaultConfig {
+        applicationId = "com.verseles.crossbar"
+        minSdk = 24
+        targetSdk = flutter.targetSdkVersion
+        versionCode = flutter.versionCode
+        versionName = flutter.versionName
+    }
+
     buildTypes {
         release {
-            // Configures the signing config for the release build.
-            if (keystoreProperties["storeFile"] != null) {
-                signingConfig = signingConfigs.getByName("release")
+            signingConfig = if (keystorePropertiesFile.exists()) {
+                signingConfigs.getByName("release")
             } else {
-                signingConfig = signingConfigs.getByName("debug")
+                signingConfigs.getByName("debug")
             }
 
             // Enable minification and obfuscation for release
@@ -68,6 +64,14 @@ android {
             )
         }
     }
+
+    applicationVariants.all {
+        outputs.forEach { output ->
+            if (output is com.android.build.gradle.internal.api.BaseVariantOutputImpl) {
+                output.outputFileName = "crossbar.apk"
+            }
+        }
+    }
 }
 
 flutter {

android/app/src/main/AndroidManifest.xml

@@ -1,6 +1,6 @@
 <manifest xmlns:android="http://schemas.android.com/apk/res/android">
     <application
-        android:label="crossbar"
+        android:label="@string/app_name"
         android:name="${applicationName}"
         android:icon="@mipmap/ic_launcher"
         android:usesCleartextTraffic="true">