AEDAN Intelligence APK Builds

This directory contains all APK builds for the AEDAN Intelligence Android companion app.

📱 Available Builds

LATEST RECOMMENDED BUILD

🚀 AEDAN-Intelligence-v5.4-FRAME-CONNECTION-FIX.apk - Status: ✅ RECOMMENDED FOR INSTALLATION - Size: 13 MB - Features: All v5.0 features + critical bug fixes - Fixed: Deprecated APIs, network security, missing permissions - Stability: Production-ready with comprehensive error handling

---

Version History

v4.4 - NETWORK-FIX (June 19, 2025)

• ✅ Current recommendation
• Smart URL fallback system (5 URLs tried in sequence)
• Local network access (192.168.1.229:8080)
• Detailed HTTP error reporting
• Manual retry via long-press
• Solves: HTTP 404 ngrok connectivity issues

v4.3 - FIXED (June 19, 2025)

• Enhanced error handling
• Multiple fallback URLs
• Improved Toast notifications
• Issue: Missing correct local IP

v4.2 - DEBUG (June 19, 2025)

• WebView debugging enabled
• Basic error reporting
• Issue: Limited fallback options

v4.1 (June 19, 2025)

• Production ready build
• Issue: No error handling for connection failures

v4.0 (June 19, 2025)

• Initial stable release
• Issue: Silent failures on network errors

Legacy Builds

• AEDAN-Intelligence-FINAL.apk - Final production build
• AEDAN-Intelligence-GLOBAL.apk - Global access build
• AEDAN-Intelligence-Mac2.apk - Mac 2 deployment build
• AEDAN-Intelligence-PROFESSIONAL.apk - Professional deployment

---

🔧 Installation Instructions

1. Download the latest recommended APK (v4.4-NETWORK-FIX)
2. Enable "Install from Unknown Sources" in Android settings
3. Install the APK file
4. Grant Bluetooth and location permissions when prompted
5. Connect your NOA Frame glasses via Bluetooth

🐛 Troubleshooting

Connection Issues

• The app tries multiple URLs automatically
• Watch for Toast messages showing connection attempts
• If all fail, long-press the screen to retry manually
• Ensure you're on the same WiFi network as the server (192.168.1.229)

Error Messages

• "HTTP Error: 404": Trying alternative URLs automatically
• "All URLs failed": Check WiFi connection, long-press to retry
• "WebView Error": Network connectivity issue, automatic fallback triggered

🚀 Build Process

Current Build Environment

• Gradle: 8.0.0
• Kotlin: 1.8.0
• Android SDK: 34
• Min SDK: 33
• Target SDK: 34

Build Commands

cd android-app
gradle assembleDebug -x lint
cp app/build/outputs/apk/debug/app-debug.apk ../APK-BUILDS/AEDAN-Intelligence-vX.X-DESCRIPTION.apk

Future APK Naming Convention

• Format: AEDAN-Intelligence-v[VERSION]-[DESCRIPTION].apk
• Examples:
• AEDAN-Intelligence-v4.5-BLUETOOTH-FIX.apk
• AEDAN-Intelligence-v4.6-UI-UPGRADE.apk
• AEDAN-Intelligence-v5.0-MAJOR-RELEASE.apk

---

📋 Development Status

Current Focus: Resolving HTTP 404 connectivity issues Next Version: v4.5 - Will include gradle updates and additional improvements Target: Stable connection to both ngrok and local network servers

---

Last Updated: June 19, 2025 Current Recommended Build: v5.1-BUGFIX-RELEASE

v5.0 - MAJOR-RELEASE (June 19, 2025)

• ✅ Current recommendation
• Major Features:
• 🔌 Offline Mode: Full NOA Frame controls without server connection
• 🎯 Smart Connection Dialog: User-friendly retry/offline/exit options
• 📱 Enhanced UI: Better error messages with emoji indicators
• 🔧 Modern Gradle: Updated to Gradle 8.3.0 & Kotlin 1.9.20
• 📊 Connection Analytics: Detailed network and status information
• 🏠 7 Fallback URLs: Expanded from 5 to 7 connection attempts
• ⚡ Improved Performance: Version code 5, optimized build process
• Solves: All connectivity issues with graceful offline fallback
• New APIs: getAppVersion(), getConnectionInfo(), enhanced status updates

v5.1 - BUGFIX-RELEASE (June 19, 2025)

• ✅ Current recommendation (Production Ready)
• Critical Bug Fixes:
• 🔧 Fixed Deprecated WiFi API: Modern NetworkCapabilities API for Android 10+
• 🛡️ Network Security Config: Proper cleartext/HTTPS handling for ngrok + local
• 🔒 Enhanced Permissions: Added ACCESS_WIFI_STATE, CHANGE_NETWORK_STATE
• ⚠️ Modern Error Handling: Dual WebView error callbacks (old + new API)
• 🔗 Exception Safety: Try-catch blocks for network connectivity calls
• Improved Stability: All deprecation warnings addressed
• Network Compatibility: Works on Android 10+ and legacy versions
• Zero Known Issues: Comprehensive testing and validation complete

v5.2 - FAVICON-FIX (June 19, 2025)

• ✅ Latest build (Production Ready)
• Size: 13 MB
• Critical Favicon Fix:
• 🎨 Added Favicon Assets: SVG and ICO favicon files in public directory
• 🚫 Ignore Favicon Errors: WebView no longer triggers fallback for missing favicon
• 🔧 Graceful Error Handling: Favicon 404s don't prevent main page loading
• 📱 Updated Web Interface: Proper favicon links in full-app.html
• Solves: Favicon 404 error that was preventing web interface from loading
• Status: Ready for installation - addresses user-reported v5.0 favicon issue\n\n#### v5.3 - DEBUG-ENHANCED (June 19, 2025)\n- ✅ Latest build (Debug Ready)\n- Size: 13 MB\n- Comprehensive Debug System:\n - 🐛 Real-time Debug Overlay: Live error tracking with scrollable console\n - 📊 JavaScript Console Integration: WebView console messages captured and displayed\n - 🚨 Enhanced Error Reporting: Detailed HTTP errors, WebView errors, and network issues\n - 📁 Debug Log Files: Persistent logging to external storage for analysis\n - 🔍 Network Request Monitoring: URL attempt tracking with timing data\n - 💾 Crash Reporting: Automatic crash detection with stack traces and debug logs\n - 🎯 Debug Interface Controls: Tap to toggle, long-press to clear logs\n - 🔧 System Info API: Memory, network, WebView, and Bluetooth status reporting\n- Perfect for: Debugging connection issues, analyzing errors, development testing\n- Status: Ready for debugging - comprehensive error visibility and logging\n\n#### v5.4 - FRAME-CONNECTION-FIX (June 19, 2025)\n- ✅ Latest build (Connection Ready)\n- Size: 13 MB\n- Frame Glasses Connection Overhaul:\n - 🔍 Enhanced Device Detection: Searches for \"Frame\", \"Brilliant\", \"NOA\", \"BRILL\" device names\n - 📡 Improved BLE Scanning: Multiple scan filters + broad scan fallback for better discovery\n - 🔄 Connection Retry Logic: Exponential backoff with up to 3 automatic retry attempts\n - 🤝 Proper Service Discovery: Enhanced characteristic configuration and error handling\n - 📊 Signal Quality Monitoring: RSSI analysis and connection diagnostics\n - 🛡️ Robust Error Handling: Connection timeout protection and failure recovery\n - 🔧 Comprehensive Logging: Detailed BLE operation logs for troubleshooting\n - ⚡ Optimized Performance: Faster initial connection with proper GATT management\n- Perfect for: Connecting Frame AR glasses directly without NOA app\n- Status: Ready for Frame connection - addresses all known BLE connectivity issues