MyAppCrew Flutter SDK #

Headless SDK for bootstrapping testers, tracking lifecycle/screen events, and batching events.

Minimal install (dependency + init) #

1. Add dependency:

flutter pub add myappcrew_flutter

2. Initialize once in main.dart:

Future<void> main() async {
  WidgetsFlutterBinding.ensureInitialized();

  await MyAppCrewFlutter.init(publicKey: 'YOUR_PUBLIC_KEY');

  runApp(const MyApp());
}

Notes:

• baseUrl is optional and defaults to https://myappcrew-tw.pages.dev.
• If publicKey is missing, the SDK disables itself (no network calls).

Optional: screen tracking (navigator observer) #

Add the navigator observer when you want screen tracking:

final observer = MyAppCrewFlutter.navigatorObserver();

MaterialApp(
  navigatorObservers: observer == null ? const [] : [observer],
  home: const MyHomePage(),
);

Optional: manual connect (claim link, token, or 6-digit code) #

1. Tester joins the invite in a browser.
2. Copy the claim token, full claim link, or 6-digit Connect Code.
3. In-app, call connectFromText(...) (token, URL, or 6-digit code):

ElevatedButton(
  onPressed: () async {
    final result = await MyAppCrewFlutter.connectFromText(inputText);
    if (result.connected) {
      // Connected
    }
  },
  child: const Text('Connect tester'),
);

Tester identity persistence #

After a successful connect, the SDK stores the tester identity and reuses it on app relaunches for the same public key. If the identity is revoked or invalid, it is cleared and you can prompt the tester to reconnect.

MyAppCrewFlutter.setOnTesterIdentityInvalid((reason) {
  // Show reconnect UI when a stored identity becomes invalid.
});

final connected = MyAppCrewFlutter.isTesterConnected();
final tester = MyAppCrewFlutter.getConnectedTester();

await MyAppCrewFlutter.disconnectTester();

Optional: connect prompt UI (debug-only by default) #

Auto-prompt testers for the 6-digit Connect Code without extra app state.

Future<void> main() async {
  WidgetsFlutterBinding.ensureInitialized();
  await MyAppCrewFlutter.init(publicKey: 'YOUR_PUBLIC_KEY');

  runApp(const MyAppCrewConnectPrompt(child: MyApp()));
}

Notes:

• Debug builds only by default. Enable in release with MyAppCrewConnectPrompt(debugOnly: false, ...).
• Testers enter the 6-digit Connect Code from the invite page.

Debugging (safe snapshot + logging) #

Read a safe snapshot that excludes secrets:

final snapshot = MyAppCrewFlutter.getDebugSnapshot();

Enable SDK logging explicitly (off by default):

MyAppCrewFlutter.setDebugLogging(true);

You can also enable logging at compile time:

flutter run --dart-define=MYAPPCREW_DEBUG_LOGS=true