|
|
@@ -10,17 +10,32 @@ apps open full-screen using the normal Android launcher mechanism. No overlays,
|
|
|
no root, no kiosk setup.
|
|
|
|
|
|
<p align="center">
|
|
|
- <em>Early preview — implementation and UI screenshots are in progress.</em>
|
|
|
+ <em>Verified on Android 15 and Android 10 tablet emulators at 1280×800.
|
|
|
+ Landscape only.</em>
|
|
|
</p>
|
|
|
|
|
|
+## Screenshots
|
|
|
+
|
|
|
+| Light | Dark |
|
|
|
+|---|---|
|
|
|
+|  |  |
|
|
|
+
|
|
|
+Also: [All apps](docs/screenshots/all-apps.png) ·
|
|
|
+[app picker](docs/screenshots/app-picker.png) ·
|
|
|
+[Settings](docs/screenshots/settings.png) ·
|
|
|
+[PIN lock](docs/screenshots/pin-lock.png) ·
|
|
|
+[1024×600 layout](docs/screenshots/home-compact-1024.png)
|
|
|
+
|
|
|
## Features
|
|
|
|
|
|
- **One home screen** — no pages, no top bar, no bottom dock; information and
|
|
|
controls live on the home page.
|
|
|
- **Large clock and date** with the device's 12/24-hour preference.
|
|
|
- **Battery, charging and Wi-Fi** status.
|
|
|
-- **Media volume** — ring, slider, step and mute controls; hardware volume keys
|
|
|
- stay in sync. This is the phone's media stream, not a private volume.
|
|
|
+- **Media volume** — ring, slider, step and mute controls. While CarDash is in
|
|
|
+ front, the hardware volume keys are routed to the same media stream, so the
|
|
|
+ dashboard and the keys always agree. This is the phone's media stream, not a
|
|
|
+ private volume.
|
|
|
- **Configurable shortcuts** for Navigation, Music and Radio. Generic icons on
|
|
|
the dashboard; real app icons in the picker and All Apps.
|
|
|
- **All apps** — searchable grid of every launchable app, launched full-screen.
|
|
|
@@ -75,8 +90,8 @@ minimum-version checks.
|
|
|
### Manual install
|
|
|
|
|
|
```bash
|
|
|
-flutter build apk --debug
|
|
|
-adb install -r build/app/outputs/flutter-apk/app-debug.apk
|
|
|
+flutter build apk --release
|
|
|
+adb install -r build/app/outputs/flutter-apk/app-release.apk
|
|
|
adb shell cmd role add-role-holder android.app.role.HOME com.wasp.cardash_launcher
|
|
|
adb shell am start -a android.intent.action.MAIN -c android.intent.category.HOME
|
|
|
```
|
|
|
@@ -96,7 +111,7 @@ same thing. Android will not let an app force itself into the home role silently
|
|
|
| All apps | Search every launchable app; tap to open |
|
|
|
| Volume ring / mute | Toggle media mute |
|
|
|
| Slider or − / + | Set media volume |
|
|
|
-| Hardware volume keys | Update the on-screen control automatically |
|
|
|
+| Hardware volume keys | Adjust the dashboard's media volume; the ring follows |
|
|
|
|
|
|
The app hides the Android status and navigation bars while CarDash is in the
|
|
|
foreground. Swipe from an edge to reveal them temporarily; they hide again when
|
|
|
@@ -152,8 +167,9 @@ flutter test
|
|
|
```
|
|
|
|
|
|
Current tests cover PIN hashing/persistence, settings persistence, theme
|
|
|
-resolution and the shortcut tile widget. Native package enumeration and the
|
|
|
-HOME role are verified on the emulator.
|
|
|
+resolution and the shortcut tile widget. Native package enumeration, the HOME
|
|
|
+role, volume, app launching and PIN flows were verified on both API 35 and
|
|
|
+API 29 tablet emulators, including the release APK.
|
|
|
|
|
|
## Compatibility and limitations
|
|
|
|
|
|
@@ -187,7 +203,6 @@ large numerals and quiet line icons. It is not a copy of that UI.
|
|
|
|
|
|
- Optional compact now-playing control beside the volume card.
|
|
|
- Configurable home layout or additional shortcut slots.
|
|
|
-- Screenshot set in `docs/screenshots/`.
|
|
|
- Release signing configuration.
|
|
|
- Real-device soak test on an Android 10 car tablet.
|
|
|
|
