Installation

Install the VECU Flutter Verifier SDK into your application and configure your host app for device-based flows.

Native Setup for NFC Delivery

If you enable NFC delivery of the verification request via Android HCE, your host app must register a native HCE service and declare the VECU AID in its manifest. Review Permissions before testing on device. Core QR-only verification does not require any native setup.

Prerequisites

Flutter >= 3.16.0
Dart >= 3.2.0, < 4.0.0
Access to the Cox Automotive package registry

Option 1: Install from Artifactory (Recommended)

The SDK is published to Cox Automotive's internal Artifactory pub registry.

Step 1: Configure pub hosted URL

Set PUB_HOSTED_URL so flutter pub get resolves VECU packages against Artifactory. You can export this in your shell profile or add it to your CI environment:

export PUB_HOSTED_URL="https://artifactory.coxautoinc.com/artifactory/api/pub/atc-pub"

Step 2: Authenticate

Authenticate dart pub against Artifactory using your Cox Automotive credentials:

dart pub token add "$PUB_HOSTED_URL"

Enter your Artifactory auth token when prompted.

Step 3: Add the dependency

Add to your app's pubspec.yaml:

dependencies:
  vecu_verifier_flutter_sdk: ^0.1.2

Then fetch dependencies:

flutter pub get

Option 2: Install from Git

If you cannot configure Artifactory access, pull the SDK directly from the GHE repository:

dependencies:
  vecu_verifier_flutter_sdk:
    git:
      url: https://ghe.coxautoinc.com/VehicleCustody/vecu-verifier-flutter-sdk.git
      ref: v0.1.2

Pin ref to a specific tag (not a branch) so your build is reproducible.

Step 4: Install iOS Pods

If you're targeting iOS:

cd ios && pod install

Repeat pod install whenever you change platform-specific plugins or update the Podfile.

Next Steps

Quick Start — Render your first verification flow
Permissions — Native NFC, HCE, Bluetooth, and entitlement setup

Vehicle Custody