tizen_interop #

This package provides Dart bindings and utility functions for using Tizen native APIs.

⚠️Caution: This package is currently under testing and not intended for production use. Some APIs may be missing or have errors.

Usage #

To use this package, add ffi and tizen_interop as dependencies in your pubspec.yaml file.

dependencies:
  ffi: ^2.0.1
  tizen_interop: ^0.2.2

Then, import package:ffi/ffi.dart and package:tizen_interop/[TIZEN_VERSION]/tizen.dart in your Dart code.

import 'package:ffi/ffi.dart';
import 'package:tizen_interop/4.0/tizen.dart';

Examples #

// Getting a string value from the Native API.
// Prefer using `arena` to allocate memory because it frees the memory
// automatically when the `using` block ends.
String appName = using((Arena arena) {
  Pointer<Pointer<Char>> ppStr = arena();
  if (tizen.app_get_name(ppStr) == 0) {
    // The memory allocated by the Native API must be freed by the caller.
    arena.using(ppStr.value, calloc.free);
    return ppStr.value.toDartString();
  }
  return 'unknown';
});

// Passing a string value to the Native API.
// The memory allocated by the `toNativeChar` method must be freed by
// the caller. The `arena` allocator will free it automatically.
using((Arena arena) {
  Pointer<Char> pKey =
      'tizen_interop_test_key_for_int'.toNativeChar(allocator: arena);
  tizen.preference_set_int(pKey, 100);
});

// Getting an integer value from the Native API.
int preferenceValue = using((Arena arena) {
  Pointer<Char> pKey =
      'tizen_interop_test_key_for_int'.toNativeChar(allocator: arena);
  Pointer<Int> pValue = arena();
  if (tizen.preference_get_int(pKey, pValue) == 0) {
    return pValue.value;
  }
  return 0;
});

// Getting a struct value from the Native API.
int freeMemory = using((Arena arena) {
  Pointer<runtime_memory_info_s> pMemInfo = arena();
  if (tizen.runtime_info_get_system_memory_info(pMemInfo) == 0) {
    return pMemInfo.ref.free;
  }
  return 0;
});

Building from source #

Install the following packages using Tizen Package Manager.

• IOT-Headed-4.0-NativeAppDevelopment-CLI
• IOT-Headed-5.0-NativeAppDevelopment-CLI
• IOT-Headed-5.5-NativeAppDevelopment-CLI
• IOT-Headed-6.0-NativeAppDevelopment-CLI
• IOT-Headed-6.5-NativeAppDevelopment-CLI

Then, run script files as follows. Dart bindings (lib/src/.../generated_bindings.dart) will be regenerated by ffigen.

./scripts/copy_rootstraps.sh
./scripts/generate_bindings.sh

Supported APIs #

This package provides bindings of the following APIs of Tizen IoT-Headed profile:

Note: UI and WebView related APIs are not provided.