# Vendor Implementation Guide: SmartDock DFC

This guide provides exhaustive documentation for Original Equipment Manufacturers (OEMs) and AOSP integrators to integrate and pre-configure SmartDock DFC.

## 1. Integration Instructions

### Source Placement
Extract your licensed SmartDock DFC distribution tarball into your AOSP source tree at the following location:
`vendor/agp-apps/smartdock`

### Inclusion in Product Build
To include SmartDock DFC, its associated system overlays, and permission whitelists in your build, add the following line to your main product makefile (e.g., `device/vendor/model/product.mk`):

```makefile
$(call inherit-product, vendor/agp-apps/smartdock/SmartDock.mk)
```

### Overriding Default Configuration
SmartDock DFC is designed to be highly flexible. While `SmartDock.mk` provides a set of sensible defaults in `PRODUCT_PROPERTY_OVERRIDES`, you can override any of these flags in your target device's specific makefile or `build.prop` to achieve the desired combination of features for your hardware.

## 2. Comprehensive Property Directory

### Core Shell Behavior
| Property | Valid Values | Description |
| :--- | :--- | :--- |
| `persist.bass.sd.layout` | `phone`, `tablet`, `desktop` | Sets the initial UI density and layout rules. |
| `persist.bass.sd.docked` | `docked`, `hidden` | Sets whether the dock is pinned (visible) or hidden by default on first boot. |
| `persist.bass.sd.activation_method` | `nav`, `swipe`, `handle` | `nav`: Uses the navigation handle area. `swipe`: Edge-based trigger. `handle`: Visible button. |
| `persist.bass.sd.reserve_space` | `true`, `false` | If true, the system reserves screen real estate at the bottom so apps do not overlap the dock. |

### Visuals & Theming
| Property | Valid Values | Description |
| :--- | :--- | :--- |
| `persist.bass.sd.theme` | `system`, `dark`, `light`, `black`, `transparent`, `material`, `fallback`, `expressive` | Sets the default theme. `expressive` enables Material 3 Expressive dynamic coloring. |
| `persist.bass.sd.icon_bg_style` | `none`, `circles`, `islands` | Sets how app icons are presented in the dock and menu. |
| `persist.bass.sd.dynamic_wallpaper_contrast` | `true`, `false` | Icons automatically flip contrast based on the wallpaper pixels beneath them. |
| `persist.bass.sd.rounded_corners` | `true`, `false` | Enables/Disables heavily rounded corners for the dock container. |
| `persist.bass.sd.dock_height` | `50` to `70` | The base height of the dock in DP. |
| `persist.bass.sd.dock_scale` | `0.5` to `1.5` | Universal UI scale multiplier for all dock elements. |
| `persist.bass.sd.enable_blur` | `true`, `false` | Enables background blur for the Apps Menu and QS drawer (Android 12+). |
| `persist.bass.sd.enable_dock_blur` | `true`, `false` | Enables background blur for the main dock bar (Android 12+). |
| `persist.bass.sd.override_panel_alpha` | `true`, `false` | Enables manual transparency override for major panels and islands. |
| `persist.bass.sd.panel_alpha` | `0` to `255` | Default transparency for panels when override is enabled. |
| `persist.bass.sd.qs_height_ratio` | `0.33`, `0.66`, `0.99` | Sets the maximum vertical height ratio for the Notification Panel. |
| `persist.bass.sd.qs_panel_width` | `100` to `200` | Sets the default relative width percentage for the Notification Panel. |
| `persist.bass.sd.qs_panel_scale` | `50` to `150` | Sets the default UI scale percentage for the Notification/QS Panel. |

### App Menu Configuration
| Property | Valid Values | Description |
| :--- | :--- | :--- |
| `persist.bass.sd.center_app_menu` | `true`, `false` | Centers the Apps Menu panel on the screen instead of aligning to the button. |
| `persist.bass.sd.center_apps_menu_button` | `true`, `false` | Places the Apps Menu trigger button in the center of the taskbar. |
| `persist.bass.sd.enable_continue_left_off` | `true`, `false` | Enables "Continue where you left off" (Recent Docs/Webpages) in the menu. |
| `persist.bass.sd.enable_recent_apps_menu` | `true`, `false` | Shows a row of recently used apps at the top of the Apps Menu. |

### System Overlays (Visual Modification)
| Property                              | Default | Description |
|:--------------------------------------| :--- | :--- |
| `persist.bass.sd.hide_status_bar`     | `false` | Enables the overlay to set system status bar height to 0. |
| `persist.bass.sd.hide_nav_bar`        | `false` | Enables the overlay to hide the AOSP navigation bar. |
| `persist.bass.sd.hide_taskbar`        | `false` | Disables the AOSP 12L+ Taskbar on large screens via overlay. |
| `persist.bass.sd.use_custom_qs`       | `true` | Replaces the system notification shade with the Material Design QS drawer. |
| `persist.bass.sd.enable_blur_overlay` | `false` | Enables system-wide background blur support via overlay. |

### Functional Restrictions & Production Lock-down
| Property | Default | Description |
| :--- | :--- | :--- |
| `persist.bass.sd.disable_statusbar_dpm` | `false` | Functionally disables the status bar and notification shade expansion via DevicePolicyManager. |
| `persist.bass.sd.disable_navbar_dpm` | `false` | Functionally disables the system navigation buttons at the framework level. |
| `persist.bass.sd.skip_onboarding` | `false` | Automatically marks the onboarding wizard as complete on first boot. |
| `persist.bass.sd.disable_customization` | `false` | Hides shell and visual customization options in the Settings activity for production devices. |

### Navigation & Display
| Property | Valid Values | Description |
| :--- | :--- | :--- |
| `persist.bass.sd.nav_mode` | `system`, `gesture`, `2button`, `3button` | Overrides the system navigation mode for the SmartDock handle. |
| `persist.bass.sd.nav_btn_justification` | `left`, `center`, `right` | Horizontal alignment of navigation buttons within the dock. |
| `persist.bass.sd.multi_display` | `true`, `false` | Enables independent dock instances on all connected displays. |
| `persist.bass.sd.supported_displays` | `primary`, `external`, `all` | Filter for which display types should initialize a SmartDock instance. |

### Input & Advanced Interaction
| Property | Default | Description |
| :--- | :--- | :--- |
| `persist.bass.sd.enable_touchpad` | `false` | Enables the Virtual Touchpad dock button by default. |
| `persist.bass.sd.auto_show_touchpad` | `false` | Automatically show the touchpad on the primary display when a secondary screen is detected. |
| `persist.bass.sd.enable_routing` | `false` | Enables the Physical Pointer Routing dock button by default. |

## 3. Deployment Check-list
1.  **Priv-App Status:** Ensure SmartDock is in `/product/priv-app/`.
2.  **Permissions:** Verify `privapp-permissions-smartdock.xml` is in `/product/etc/permissions/`.
3.  **Stability:** Verify `sysconfig-smartdock.xml` is in `/product/etc/sysconfig/`.
4.  **Properties:** Add your desired defaults to `build.prop` using the table above.