devcycle_flutter_client_sdk 1.11.6

Official Flutter Client SDK for DevCycle. Supports iOS and Android.

example/lib/main.dart

import 'package:flutter/material.dart';
import 'package:logger/logger.dart';
import 'dart:async';
import 'dart:convert';

import 'package:flutter/services.dart';
import 'package:devcycle_flutter_client_sdk/devcycle_flutter_client_sdk.dart';

void main() {
  runApp(const MyApp());
}

class MyApp extends StatefulWidget {
  const MyApp({super.key});

  @override
  State<MyApp> createState() => _MyAppState();
}

class _MyAppState extends State<MyApp> {
  final _logger = Logger();
  String _platformVersion = 'Unknown';
  String _displayValue = '';
  String _variableValue = '';
  bool _booleanValue = false;
  num _integerValue = 0;
  num _doubleValue = 0.0;
  var _jsonArrayValue = '';
  var _jsonObjectValue = '';

  var encodedJsonArray = '''
  [
    {"score": 40},
    {"score": 80}
  ]
''';
  var encodedJsonObject = '''
  {
    "score1": 40,
    "score2": 80
  }
''';

  final _devCycleClient = DevCycleClientBuilder()
      .sdkKey('<DEVCYCLE_MOBILE_SDK_KEY>')
      .user(DevCycleUserBuilder().userId('123').build())
      .options(DevCycleOptionsBuilder().logLevel(LogLevel.debug).build())
      .build();

  @override
  void initState() {
    super.initState();
    initPlatformState();
    initVariable();
  }

  // Platform messages are asynchronous, so we initialize in an async method.
  Future<void> initPlatformState() async {
    String platformVersion;
    // Platform messages may fail, so we use a try/catch PlatformException.
    // We also handle the message potentially returning null.
    try {
      platformVersion = await _devCycleClient.getPlatformVersion() ??
          'Unknown platform version';
    } on PlatformException {
      platformVersion = 'Failed to get platform version.';
    }

    // If the widget was removed from the tree while the asynchronous platform
    // message was in flight, we want to discard the reply rather than calling
    // setState to update our non-existent appearance.
    if (!mounted) return;

    setState(() {
      _platformVersion = platformVersion;
    });
  }

  Future<void> initVariable() async {
    // Wait for client to initialize before fetching variables
    _devCycleClient.onInitialized(([error]) async {
      setState(() {
        _displayValue = error ?? 'DevCycle Client initialized';
      });

      final variable =
          await _devCycleClient.variable('string-variable', 'Default Value');
      setState(() {
        _variableValue = variable.value;
      });
      variable.onUpdate((updatedValue) {
        setState(() {
          _variableValue = updatedValue;
        });
      });

      final booleanVariable =
          await _devCycleClient.variable('boolean-variable', false);
      setState(() {
        _booleanValue = booleanVariable.value;
      });
      booleanVariable.onUpdate((updatedValue) {
        setState(() {
          _booleanValue = updatedValue;
        });
      });

      final integerVariable =
          await _devCycleClient.variable('integer-variable', 188);
      setState(() {
        _integerValue = integerVariable.value;
      });
      integerVariable.onUpdate((updatedValue) {
        setState(() {
          _integerValue = updatedValue;
        });
      });

      final doubleVariable =
          await _devCycleClient.variable('decimal-variable', 1.88);
      setState(() {
        _doubleValue = doubleVariable.value;
      });
      doubleVariable.onUpdate((updatedValue) {
        setState(() {
          _doubleValue = updatedValue;
        });
      });

      final jsonArrayVariable = await _devCycleClient.variable(
          'json-array-variable', jsonDecode(encodedJsonArray));
      setState(() {
        _jsonArrayValue = jsonEncode(jsonArrayVariable.value);
      });
      jsonArrayVariable.onUpdate((updatedValue) {
        setState(() {
          _jsonArrayValue = jsonEncode(updatedValue);
        });
      });

      final jsonObjectVariable = await _devCycleClient.variable(
          'json-object-variable', jsonDecode(encodedJsonObject));
      setState(() {
        _jsonObjectValue = jsonEncode(jsonObjectVariable.value);
      });
      jsonObjectVariable.onUpdate((updatedValue) {
        setState(() {
          _jsonObjectValue = jsonEncode(updatedValue);
        });
      });
    });
  }

  void resetUser() {
    _devCycleClient.resetUser();
    setState(() {
      _displayValue = 'User reset!';
    });
  }

  void identifyUser() {
    DevCycleUser testUser =
        DevCycleUserBuilder().userId('test_user_123').build();
    _devCycleClient.identifyUser(testUser, ((err, variables) {
      if (err != null) {
        setState(() {
          _displayValue = err;
        });
      } else {
        _logger.d(variables.values
            .map((variable) => "${variable.key}: ${variable.value}")
            .toString());
      }
    }));
    setState(() {
      _displayValue = 'Identified user: \n${testUser.toString()}';
    });
  }

  void identifyAnonUser() {
    DevCycleUser anonUser = DevCycleUserBuilder().isAnonymous(true).build();
    _devCycleClient.identifyUser(anonUser);
    setState(() {
      _displayValue = 'Identified user: \n${anonUser.toString()}';
    });
  }

  void trackEvent() {
    DevCycleEvent event = DevCycleEventBuilder()
        .target('target-str')
        .type('flutter-test')
        .value(10.0)
        .metaData({'custom_key': 'value'}).build();
    _devCycleClient.track(event);
    setState(() {
      _displayValue = 'Tracked event: \n${event.toString()}';
    });
  }

  void showAllFeatures() async {
    Map<String, DVCFeature> features = await _devCycleClient.allFeatures();
    setState(() {
      _displayValue = 'All features: \n${features.keys.toString()}';
    });
  }

  void flushEvents() {
    _devCycleClient.flushEvents(([error]) {
      setState(() {
        _displayValue = error ?? 'Flushed events';
      });
    });
  }

  void showAllVariables() async {
    Map<String, DVCVariable> variables = await _devCycleClient.allVariables();

    // Build detailed info including EvalReason
    String variableInfo = 'All variables:\n';
    for (var variable in variables.values) {
      variableInfo += '\n${variable.key}: ${variable.value}\n';
      if (variable.eval != null) {
        variableInfo +=
            '  Eval: ${variable.eval!.reason} - ${variable.eval!.details}';
        if (variable.eval!.targetId != null) {
          variableInfo += ' (target: ${variable.eval!.targetId})';
        }
        variableInfo += '\n';
      }
    }

    setState(() {
      _displayValue = variableInfo;
    });
  }

  void showEvalReason() async {
    final variable =
        await _devCycleClient.variable('string-variable', 'Default Value');
    String info = 'Variable: ${variable.key}\n';
    info += 'Value: ${variable.value}\n';
    info += 'Type: ${variable.type}\n';
    if (variable.eval != null) {
      info += '\nEvalReason:\n';
      info += '  reason: ${variable.eval!.reason}\n';
      info += '  details: ${variable.eval!.details}\n';
      info += '  targetId: ${variable.eval!.targetId}\n';
    } else {
      info += '\nEvalReason: null\n';
    }

    setState(() {
      _displayValue = info;
    });
  }

  @override
  Widget build(BuildContext context) {
    return MaterialApp(
      home: Scaffold(
        appBar: AppBar(
          title: const Text('Plugin example app'),
        ),
        body: SafeArea(
          child: SingleChildScrollView(
            padding: const EdgeInsets.all(16.0),
            child: Column(
              crossAxisAlignment: CrossAxisAlignment.stretch,
              children: [
                Text(
                  "String Value: $_variableValue",
                  textAlign: TextAlign.center,
                ),
                Text(
                  "Bool Value: $_booleanValue",
                  textAlign: TextAlign.center,
                ),
                const SizedBox(height: 4),
                Text(
                  "Int Value: $_integerValue",
                  textAlign: TextAlign.center,
                ),
                const SizedBox(height: 4),
                Text(
                  "Double Value: $_doubleValue",
                  textAlign: TextAlign.center,
                ),
                const SizedBox(height: 4),
                Text(
                  "JSON Array Value: $_jsonArrayValue",
                  textAlign: TextAlign.center,
                ),
                const SizedBox(height: 4),
                Text(
                  "JSON Object Value: $_jsonObjectValue",
                  textAlign: TextAlign.center,
                ),
                const SizedBox(height: 4),
                Text(
                  'Running on: $_platformVersion',
                  textAlign: TextAlign.center,
                ),
                const SizedBox(height: 16),
                Row(
                  mainAxisAlignment: MainAxisAlignment.center,
                  children: [
                    Icon(
                      Icons.star,
                      color: _booleanValue ? Colors.blue[500] : Colors.red[500],
                    ),
                    const SizedBox(width: 16),
                    _booleanValue
                        ? const Icon(
                            Icons.sentiment_very_satisfied,
                            color: Colors.grey,
                          )
                        : const Icon(
                            Icons.sentiment_very_dissatisfied,
                            color: Colors.grey,
                          ),
                  ],
                ),
                const SizedBox(height: 16),
                ElevatedButton(
                    onPressed: showAllFeatures,
                    child: const Text('All Features')),
                const SizedBox(height: 8),
                ElevatedButton(
                    onPressed: showAllVariables,
                    child: const Text('All Variables')),
                const SizedBox(height: 8),
                ElevatedButton(
                    onPressed: showEvalReason,
                    child: const Text('Show EvalReason')),
                const SizedBox(height: 8),
                ElevatedButton(
                    onPressed: identifyUser,
                    child: const Text('Identify User')),
                const SizedBox(height: 8),
                ElevatedButton(
                    onPressed: identifyAnonUser,
                    child: const Text('Identify Anonymous User')),
                const SizedBox(height: 8),
                ElevatedButton(
                    onPressed: resetUser, child: const Text('Reset User')),
                const SizedBox(height: 8),
                ElevatedButton(
                    onPressed: trackEvent, child: const Text('Track Event')),
                const SizedBox(height: 8),
                ElevatedButton(
                    onPressed: flushEvents, child: const Text('FlushEvents')),
                const SizedBox(height: 16),
                Container(
                  padding: const EdgeInsets.all(12.0),
                  decoration: BoxDecoration(
                    color: Colors.grey[200],
                    borderRadius: BorderRadius.circular(8),
                  ),
                  child: Text(
                    _displayValue,
                    style: const TextStyle(fontSize: 12),
                  ),
                ),
                const SizedBox(height: 16),
              ],
            ),
          ),
        ),
      ),
    );
  }
}