From dd3a024aa868ae3a5e064aa9071f89a3b97825f0 Mon Sep 17 00:00:00 2001
From: Hossein Yousefi <u.hossein@yahoo.com>
Date: Mon, 20 Feb 2023 10:56:12 +0100
Subject: [PATCH] [experimental/pedometer] Use `jnigen` and `jni` version from
pub instead of git url. (#1655)
---
experimental/pedometer/.metadata | 3 +
experimental/pedometer/README.md | 8 +-
experimental/pedometer/android/.gitignore | 9 +
experimental/pedometer/android/build.gradle | 59 +
.../pedometer/android/settings.gradle | 1 +
.../android/src/main/AndroidManifest.xml | 3 +
.../example/android/app/build.gradle | 6 -
experimental/pedometer/example/pubspec.yaml | 6 +-
experimental/pedometer/jnigen.yaml | 3 +-
.../pedometer/lib/health_connect.dart | 26 +-
experimental/pedometer/lib/main.dart | 1 -
experimental/pedometer/pubspec.yaml | 14 +-
.../pedometer/src/health_connect/dartjni.h | 7 +-
.../src/health_connect/include/BUILD.gn | 23 -
.../include/analyze_snapshot_api.h | 30 -
.../health_connect/include/bin/dart_io_api.h | 69 -
.../src/health_connect/include/dart_api.h | 4098 -----------------
.../src/health_connect/include/dart_api_dl.c | 59 -
.../src/health_connect/include/dart_api_dl.h | 150 -
.../include/dart_embedder_api.h | 108 -
.../health_connect/include/dart_native_api.h | 205 -
.../health_connect/include/dart_tools_api.h | 620 ---
.../src/health_connect/include/dart_version.h | 16 -
.../include/internal/dart_api_dl_impl.h | 21 -
24 files changed, 98 insertions(+), 5447 deletions(-)
create mode 100644 experimental/pedometer/android/.gitignore
create mode 100644 experimental/pedometer/android/build.gradle
create mode 100644 experimental/pedometer/android/settings.gradle
create mode 100644 experimental/pedometer/android/src/main/AndroidManifest.xml
delete mode 100644 experimental/pedometer/lib/main.dart
delete mode 100644 experimental/pedometer/src/health_connect/include/BUILD.gn
delete mode 100644 experimental/pedometer/src/health_connect/include/analyze_snapshot_api.h
delete mode 100644 experimental/pedometer/src/health_connect/include/bin/dart_io_api.h
delete mode 100644 experimental/pedometer/src/health_connect/include/dart_api.h
delete mode 100644 experimental/pedometer/src/health_connect/include/dart_api_dl.c
delete mode 100644 experimental/pedometer/src/health_connect/include/dart_api_dl.h
delete mode 100644 experimental/pedometer/src/health_connect/include/dart_embedder_api.h
delete mode 100644 experimental/pedometer/src/health_connect/include/dart_native_api.h
delete mode 100644 experimental/pedometer/src/health_connect/include/dart_tools_api.h
delete mode 100644 experimental/pedometer/src/health_connect/include/dart_version.h
delete mode 100644 experimental/pedometer/src/health_connect/include/internal/dart_api_dl_impl.h
diff --git a/experimental/pedometer/.metadata b/experimental/pedometer/.metadata
index 4defcaca8..795ad527a 100644
--- a/experimental/pedometer/.metadata
+++ b/experimental/pedometer/.metadata
@@ -15,6 +15,9 @@ migration:
- platform: root
create_revision: 098aac7ffeef2a1846eb3a7f14788520c8400a14
base_revision: 098aac7ffeef2a1846eb3a7f14788520c8400a14
+ - platform: android
+ create_revision: 098aac7ffeef2a1846eb3a7f14788520c8400a14
+ base_revision: 098aac7ffeef2a1846eb3a7f14788520c8400a14
- platform: ios
create_revision: 098aac7ffeef2a1846eb3a7f14788520c8400a14
base_revision: 098aac7ffeef2a1846eb3a7f14788520c8400a14
diff --git a/experimental/pedometer/README.md b/experimental/pedometer/README.md
index e3402143f..a6ec0deb9 100644
--- a/experimental/pedometer/README.md
+++ b/experimental/pedometer/README.md
@@ -17,12 +17,10 @@ Configuration for FFIgen is [here](/ffigen.yaml) for the [CoreMotion](https://de
`dart run ffigen --config ffigen.yaml`
### JNIgen
-Configuration for JNIgen is [here](/jnigen.yaml) for the [HealthConnect API](https://developer.android.com/guide/health-and-fitness/health-connect). Right now, JNIgen requires an Android folder to generate the bindings so there are a few steps to regenerate:
+Configuration for JNIgen is [here](/jnigen.yaml) for the [HealthConnect API](https://developer.android.com/guide/health-and-fitness/health-connect).
-1. `flutter create .`
-2. `flutter build apk`
-3. `dart run jnigen --config jnigen.yaml`
-4. delete the android folder
+1. `cd Example && flutter build apk`
+2. `cd .. && dart run jnigen --config jnigen.yaml`
## Running the example app
diff --git a/experimental/pedometer/android/.gitignore b/experimental/pedometer/android/.gitignore
new file mode 100644
index 000000000..161bdcdaf
--- /dev/null
+++ b/experimental/pedometer/android/.gitignore
@@ -0,0 +1,9 @@
+*.iml
+.gradle
+/local.properties
+/.idea/workspace.xml
+/.idea/libraries
+.DS_Store
+/build
+/captures
+.cxx
diff --git a/experimental/pedometer/android/build.gradle b/experimental/pedometer/android/build.gradle
new file mode 100644
index 000000000..fab0c0cd4
--- /dev/null
+++ b/experimental/pedometer/android/build.gradle
@@ -0,0 +1,59 @@
+// The Android Gradle Plugin builds the native code with the Android NDK.
+
+group 'dev.flutter.pedometer'
+version '1.0'
+
+buildscript {
+ repositories {
+ google()
+ mavenCentral()
+ }
+
+ dependencies {
+ // The Android Gradle Plugin knows how to build native code with the NDK.
+ classpath 'com.android.tools.build:gradle:7.2.0'
+ }
+}
+
+rootProject.allprojects {
+ repositories {
+ google()
+ mavenCentral()
+ }
+}
+
+apply plugin: 'com.android.library'
+
+android {
+ // Bumping the plugin compileSdkVersion requires all clients of this plugin
+ // to bump the version in their app.
+ compileSdkVersion 31
+
+ // Bumping the plugin ndkVersion requires all clients of this plugin to bump
+ // the version in their app and to download a newer version of the NDK.
+ ndkVersion "21.4.7075529"
+
+ // Invoke the shared CMake build with the Android Gradle Plugin.
+ externalNativeBuild {
+ cmake {
+ path "../src/health_connect/CMakeLists.txt"
+
+ // The default CMake version for the Android Gradle Plugin is 3.10.2.
+ // https://developer.android.com/studio/projects/install-ndk#vanilla_cmake
+ //
+ // The Flutter tooling requires that developers have CMake 3.10 or later
+ // installed. You should not increase this version, as doing so will cause
+ // the plugin to fail to compile for some customers of the plugin.
+ // version "3.10.2"
+ }
+ }
+
+ compileOptions {
+ sourceCompatibility JavaVersion.VERSION_1_8
+ targetCompatibility JavaVersion.VERSION_1_8
+ }
+
+ defaultConfig {
+ minSdkVersion 16
+ }
+}
diff --git a/experimental/pedometer/android/settings.gradle b/experimental/pedometer/android/settings.gradle
new file mode 100644
index 000000000..f295a58f7
--- /dev/null
+++ b/experimental/pedometer/android/settings.gradle
@@ -0,0 +1 @@
+rootProject.name = 'pedometer'
diff --git a/experimental/pedometer/android/src/main/AndroidManifest.xml b/experimental/pedometer/android/src/main/AndroidManifest.xml
new file mode 100644
index 000000000..1a19daf14
--- /dev/null
+++ b/experimental/pedometer/android/src/main/AndroidManifest.xml
@@ -0,0 +1,3 @@
+<manifest xmlns:android="http://schemas.android.com/apk/res/android"
+ package="dev.flutter.pedometer">
+</manifest>
diff --git a/experimental/pedometer/example/android/app/build.gradle b/experimental/pedometer/example/android/app/build.gradle
index 20998ca96..d7627dcca 100644
--- a/experimental/pedometer/example/android/app/build.gradle
+++ b/experimental/pedometer/example/android/app/build.gradle
@@ -65,12 +65,6 @@ android {
signingConfig signingConfigs.debug
}
}
-
- externalNativeBuild {
- cmake {
- path "../../../src/health_connect/CMakeLists.txt"
- }
- }
}
flutter {
diff --git a/experimental/pedometer/example/pubspec.yaml b/experimental/pedometer/example/pubspec.yaml
index 1df87eb09..7efec7ac8 100644
--- a/experimental/pedometer/example/pubspec.yaml
+++ b/experimental/pedometer/example/pubspec.yaml
@@ -44,11 +44,7 @@ dependencies:
cupertino_icons: ^1.0.2
ffi: ^2.0.1
intl: ^0.18.0
- jni:
- git:
- url: https://github.com/dart-lang/jnigen
- ref: suspend-fun
- path: ./jni
+ jni: ^0.3.0
fl_chart: ^0.55.2
dev_dependencies:
diff --git a/experimental/pedometer/jnigen.yaml b/experimental/pedometer/jnigen.yaml
index 3f140db9b..f050cb3a3 100644
--- a/experimental/pedometer/jnigen.yaml
+++ b/experimental/pedometer/jnigen.yaml
@@ -1,11 +1,10 @@
android_sdk_config:
add_gradle_deps: true
+ android_example: 'example/'
summarizer:
backend: asm
-# Experimental flag to convert suspend functions in Kotlin to Dart async
-# functions. Only available in suspend-fun branch of jnigen for now.
suspend_fun_to_async: true
output:
diff --git a/experimental/pedometer/lib/health_connect.dart b/experimental/pedometer/lib/health_connect.dart
index ea44f7dce..292f4fda1 100644
--- a/experimental/pedometer/lib/health_connect.dart
+++ b/experimental/pedometer/lib/health_connect.dart
@@ -77,7 +77,7 @@ class HealthConnectClient extends jni.JObject {
final $p = ReceivePort();
final $c = jni.Jni.newPortContinuation($p);
_insertRecords(reference, list.reference, $c).object;
- final $o = ffi.Pointer<ffi.Void>.fromAddress(await $p.first);
+ final $o = jni.JObjectPtr.fromAddress(await $p.first);
final $k = const jni.JObjectType().getClass().reference;
if (jni.Jni.env.IsInstanceOf($o, $k) == 0) {
throw "Failed";
@@ -101,7 +101,7 @@ class HealthConnectClient extends jni.JObject {
final $p = ReceivePort();
final $c = jni.Jni.newPortContinuation($p);
_updateRecords(reference, list.reference, $c).object;
- final $o = ffi.Pointer<ffi.Void>.fromAddress(await $p.first);
+ final $o = jni.JObjectPtr.fromAddress(await $p.first);
final $k = const jni.JObjectType().getClass().reference;
if (jni.Jni.env.IsInstanceOf($o, $k) == 0) {
throw "Failed";
@@ -134,7 +134,7 @@ class HealthConnectClient extends jni.JObject {
_deleteRecords(
reference, kClass.reference, list.reference, list1.reference, $c)
.object;
- final $o = ffi.Pointer<ffi.Void>.fromAddress(await $p.first);
+ final $o = jni.JObjectPtr.fromAddress(await $p.first);
final $k = const jni.JObjectType().getClass().reference;
if (jni.Jni.env.IsInstanceOf($o, $k) == 0) {
throw "Failed";
@@ -162,7 +162,7 @@ class HealthConnectClient extends jni.JObject {
final $c = jni.Jni.newPortContinuation($p);
_deleteRecords1(reference, kClass.reference, timeRangeFilter.reference, $c)
.object;
- final $o = ffi.Pointer<ffi.Void>.fromAddress(await $p.first);
+ final $o = jni.JObjectPtr.fromAddress(await $p.first);
final $k = const jni.JObjectType().getClass().reference;
if (jni.Jni.env.IsInstanceOf($o, $k) == 0) {
throw "Failed";
@@ -188,7 +188,7 @@ class HealthConnectClient extends jni.JObject {
final $p = ReceivePort();
final $c = jni.Jni.newPortContinuation($p);
_readRecord(reference, kClass.reference, string.reference, $c).object;
- final $o = ffi.Pointer<ffi.Void>.fromAddress(await $p.first);
+ final $o = jni.JObjectPtr.fromAddress(await $p.first);
final $k = const jni.JObjectType().getClass().reference;
if (jni.Jni.env.IsInstanceOf($o, $k) == 0) {
throw "Failed";
@@ -213,7 +213,7 @@ class HealthConnectClient extends jni.JObject {
final $p = ReceivePort();
final $c = jni.Jni.newPortContinuation($p);
_readRecords(reference, readRecordsRequest.reference, $c).object;
- final $o = ffi.Pointer<ffi.Void>.fromAddress(await $p.first);
+ final $o = jni.JObjectPtr.fromAddress(await $p.first);
final $k = const jni.JObjectType().getClass().reference;
if (jni.Jni.env.IsInstanceOf($o, $k) == 0) {
throw "Failed";
@@ -237,7 +237,7 @@ class HealthConnectClient extends jni.JObject {
final $p = ReceivePort();
final $c = jni.Jni.newPortContinuation($p);
_aggregate(reference, aggregateRequest.reference, $c).object;
- final $o = ffi.Pointer<ffi.Void>.fromAddress(await $p.first);
+ final $o = jni.JObjectPtr.fromAddress(await $p.first);
final $k = const $AggregationResultType().getClass().reference;
if (jni.Jni.env.IsInstanceOf($o, $k) == 0) {
throw "Failed";
@@ -263,7 +263,7 @@ class HealthConnectClient extends jni.JObject {
_aggregateGroupByDuration(
reference, aggregateGroupByDurationRequest.reference, $c)
.object;
- final $o = ffi.Pointer<ffi.Void>.fromAddress(await $p.first);
+ final $o = jni.JObjectPtr.fromAddress(await $p.first);
final $k = const jni.JObjectType().getClass().reference;
if (jni.Jni.env.IsInstanceOf($o, $k) == 0) {
throw "Failed";
@@ -289,7 +289,7 @@ class HealthConnectClient extends jni.JObject {
_aggregateGroupByPeriod(
reference, aggregateGroupByPeriodRequest.reference, $c)
.object;
- final $o = ffi.Pointer<ffi.Void>.fromAddress(await $p.first);
+ final $o = jni.JObjectPtr.fromAddress(await $p.first);
final $k = const jni.JObjectType().getClass().reference;
if (jni.Jni.env.IsInstanceOf($o, $k) == 0) {
throw "Failed";
@@ -313,7 +313,7 @@ class HealthConnectClient extends jni.JObject {
final $p = ReceivePort();
final $c = jni.Jni.newPortContinuation($p);
_getChangesToken(reference, changesTokenRequest.reference, $c).object;
- final $o = ffi.Pointer<ffi.Void>.fromAddress(await $p.first);
+ final $o = jni.JObjectPtr.fromAddress(await $p.first);
final $k = const jni.JStringType().getClass().reference;
if (jni.Jni.env.IsInstanceOf($o, $k) == 0) {
throw "Failed";
@@ -337,7 +337,7 @@ class HealthConnectClient extends jni.JObject {
final $p = ReceivePort();
final $c = jni.Jni.newPortContinuation($p);
_getChanges(reference, string.reference, $c).object;
- final $o = ffi.Pointer<ffi.Void>.fromAddress(await $p.first);
+ final $o = jni.JObjectPtr.fromAddress(await $p.first);
final $k = const jni.JObjectType().getClass().reference;
if (jni.Jni.env.IsInstanceOf($o, $k) == 0) {
throw "Failed";
@@ -457,7 +457,7 @@ class PermissionController extends jni.JObject {
final $p = ReceivePort();
final $c = jni.Jni.newPortContinuation($p);
_getGrantedPermissions(reference, set0.reference, $c).object;
- final $o = ffi.Pointer<ffi.Void>.fromAddress(await $p.first);
+ final $o = jni.JObjectPtr.fromAddress(await $p.first);
final $k = const $SetType(jni.JObjectType()).getClass().reference;
if (jni.Jni.env.IsInstanceOf($o, $k) == 0) {
throw "Failed";
@@ -480,7 +480,7 @@ class PermissionController extends jni.JObject {
final $p = ReceivePort();
final $c = jni.Jni.newPortContinuation($p);
_revokeAllPermissions(reference, $c).object;
- final $o = ffi.Pointer<ffi.Void>.fromAddress(await $p.first);
+ final $o = jni.JObjectPtr.fromAddress(await $p.first);
final $k = const jni.JObjectType().getClass().reference;
if (jni.Jni.env.IsInstanceOf($o, $k) == 0) {
throw "Failed";
diff --git a/experimental/pedometer/lib/main.dart b/experimental/pedometer/lib/main.dart
deleted file mode 100644
index ab73b3a23..000000000
--- a/experimental/pedometer/lib/main.dart
+++ /dev/null
@@ -1 +0,0 @@
-void main() {}
diff --git a/experimental/pedometer/pubspec.yaml b/experimental/pedometer/pubspec.yaml
index bff084378..1d9778c11 100644
--- a/experimental/pedometer/pubspec.yaml
+++ b/experimental/pedometer/pubspec.yaml
@@ -11,20 +11,12 @@ dependencies:
flutter:
sdk: flutter
plugin_platform_interface: ^2.0.2
- jni:
- git:
- url: https://github.com/dart-lang/jnigen
- ref: suspend-fun
- path: ./jni
+ jni: ^0.3.0
ffi: ^2.0.1
dev_dependencies:
ffigen: ^7.2.1
- jnigen:
- git:
- url: https://github.com/dart-lang/jnigen
- ref: suspend-fun
- path: ./jnigen
+ jnigen: ^0.3.0
flutter_test:
sdk: flutter
flutter_lints: ^2.0.0
@@ -50,6 +42,8 @@ flutter:
platforms:
ios:
ffiPlugin: true
+ android:
+ ffiPlugin: true
# To add assets to your plugin package, add an assets section, like this:
# assets:
diff --git a/experimental/pedometer/src/health_connect/dartjni.h b/experimental/pedometer/src/health_connect/dartjni.h
index 46907544a..39b70bd8f 100644
--- a/experimental/pedometer/src/health_connect/dartjni.h
+++ b/experimental/pedometer/src/health_connect/dartjni.h
@@ -10,11 +10,6 @@
#include <stdio.h>
#include <stdlib.h>
-#include "include/dart_api.h"
-#include "include/dart_native_api.h"
-
-#include "include/dart_api_dl.h"
-
#if _WIN32
#include <windows.h>
#else
@@ -266,7 +261,7 @@ static inline jthrowable check_exception() {
return to_global_ref(exception);
}
-DART_EXPORT intptr_t InitDartApiDL(void* data);
+FFI_PLUGIN_EXPORT intptr_t InitDartApiDL(void* data);
JNIEXPORT void JNICALL
Java_com_github_dart_1lang_jni_PortContinuation__1resumeWith(JNIEnv* env,
diff --git a/experimental/pedometer/src/health_connect/include/BUILD.gn b/experimental/pedometer/src/health_connect/include/BUILD.gn
deleted file mode 100644
index 2b10262f8..000000000
--- a/experimental/pedometer/src/health_connect/include/BUILD.gn
+++ /dev/null
@@ -1,23 +0,0 @@
-# Copyright (c) 2021, the Dart project authors. Please see the AUTHORS file
-# for details. All rights reserved. Use of this source code is governed by a
-# BSD-style license that can be found in the LICENSE file.
-
-import("../../sdk_args.gni")
-
-# This rule copies header files to include/
-copy("copy_headers") {
- visibility = [ "../../sdk:copy_headers" ]
-
- sources = [
- "dart_api.h",
- "dart_api_dl.c",
- "dart_api_dl.h",
- "dart_native_api.h",
- "dart_tools_api.h",
- "dart_version.h",
- "internal/dart_api_dl_impl.h",
- ]
-
- outputs =
- [ "$root_out_dir/$dart_sdk_output/include/{{source_target_relative}}" ]
-}
diff --git a/experimental/pedometer/src/health_connect/include/analyze_snapshot_api.h b/experimental/pedometer/src/health_connect/include/analyze_snapshot_api.h
deleted file mode 100644
index 0e68d5ccb..000000000
--- a/experimental/pedometer/src/health_connect/include/analyze_snapshot_api.h
+++ /dev/null
@@ -1,30 +0,0 @@
-/*
- * Copyright (c) 2021, the Dart project authors. Please see the AUTHORS file
- * for details. All rights reserved. Use of this source code is governed by a
- * BSD-style license that can be found in the LICENSE file.
- */
-
-#ifndef RUNTIME_INCLUDE_ANALYZE_SNAPSHOT_API_H_
-#define RUNTIME_INCLUDE_ANALYZE_SNAPSHOT_API_H_
-
-#include <stdint.h>
-
-namespace dart {
-namespace snapshot_analyzer {
-typedef struct {
- const uint8_t* vm_snapshot_data;
- const uint8_t* vm_snapshot_instructions;
- const uint8_t* vm_isolate_data;
- const uint8_t* vm_isolate_instructions;
-} Dart_SnapshotAnalyzerInformation;
-
-void Dart_DumpSnapshotInformationAsJson(char** buffer,
- intptr_t* buffer_length,
- Dart_SnapshotAnalyzerInformation* info);
-
-void Dart_DumpSnapshotInformationPP(Dart_SnapshotAnalyzerInformation* info);
-
-} // namespace snapshot_analyzer
-} // namespace dart
-
-#endif // RUNTIME_INCLUDE_ANALYZE_SNAPSHOT_API_H_
diff --git a/experimental/pedometer/src/health_connect/include/bin/dart_io_api.h b/experimental/pedometer/src/health_connect/include/bin/dart_io_api.h
deleted file mode 100644
index cc647976c..000000000
--- a/experimental/pedometer/src/health_connect/include/bin/dart_io_api.h
+++ /dev/null
@@ -1,69 +0,0 @@
-// Copyright (c) 2015, the Dart project authors. Please see the AUTHORS file
-// for details. All rights reserved. Use of this source code is governed by a
-// BSD-style license that can be found in the LICENSE file.
-
-#ifndef RUNTIME_INCLUDE_BIN_DART_IO_API_H_
-#define RUNTIME_INCLUDE_BIN_DART_IO_API_H_
-
-#include "dart_tools_api.h"
-
-namespace dart {
-namespace bin {
-
-// Bootstraps 'dart:io'.
-void BootstrapDartIo();
-
-// Cleans up 'dart:io'.
-void CleanupDartIo();
-
-// Lets dart:io know where the system temporary directory is located.
-// Currently only wired up on Android.
-void SetSystemTempDirectory(const char* system_temp);
-
-// Tells the system whether to capture Stdout events.
-void SetCaptureStdout(bool value);
-
-// Tells the system whether to capture Stderr events.
-void SetCaptureStderr(bool value);
-
-// Should Stdout events be captured?
-bool ShouldCaptureStdout();
-
-// Should Stderr events be captured?
-bool ShouldCaptureStderr();
-
-// Set the executable name used by Platform.executable.
-void SetExecutableName(const char* executable_name);
-
-// Set the arguments used by Platform.executableArguments.
-void SetExecutableArguments(int script_index, char** argv);
-
-// Set dart:io implementation specific fields of Dart_EmbedderInformation.
-void GetIOEmbedderInformation(Dart_EmbedderInformation* info);
-
-// Appropriate to assign to Dart_InitializeParams.file_open/read/write/close.
-void* OpenFile(const char* name, bool write);
-void ReadFile(uint8_t** data, intptr_t* file_len, void* stream);
-void WriteFile(const void* buffer, intptr_t num_bytes, void* stream);
-void CloseFile(void* stream);
-
-// Generates 'length' random bytes into 'buffer'. Returns true on success
-// and false on failure. This is appropriate to assign to
-// Dart_InitializeParams.entropy_source.
-bool GetEntropy(uint8_t* buffer, intptr_t length);
-
-// Performs a lookup of the I/O Dart_NativeFunction with a specified 'name' and
-// 'argument_count'. Returns NULL if no I/O native function with a matching
-// name and parameter count is found.
-Dart_NativeFunction LookupIONative(Dart_Handle name,
- int argument_count,
- bool* auto_setup_scope);
-
-// Returns the symbol for I/O native function 'nf'. Returns NULL if 'nf' is not
-// a valid I/O native function.
-const uint8_t* LookupIONativeSymbol(Dart_NativeFunction nf);
-
-} // namespace bin
-} // namespace dart
-
-#endif // RUNTIME_INCLUDE_BIN_DART_IO_API_H_
diff --git a/experimental/pedometer/src/health_connect/include/dart_api.h b/experimental/pedometer/src/health_connect/include/dart_api.h
deleted file mode 100644
index 741447a06..000000000
--- a/experimental/pedometer/src/health_connect/include/dart_api.h
+++ /dev/null
@@ -1,4098 +0,0 @@
-/*
- * Copyright (c) 2012, the Dart project authors. Please see the AUTHORS file
- * for details. All rights reserved. Use of this source code is governed by a
- * BSD-style license that can be found in the LICENSE file.
- */
-
-#ifndef RUNTIME_INCLUDE_DART_API_H_
-#define RUNTIME_INCLUDE_DART_API_H_
-
-/** \mainpage Dart Embedding API Reference
- *
- * This reference describes the Dart Embedding API, which is used to embed the
- * Dart Virtual Machine within C/C++ applications.
- *
- * This reference is generated from the header include/dart_api.h.
- */
-
-/* __STDC_FORMAT_MACROS has to be defined before including <inttypes.h> to
- * enable platform independent printf format specifiers. */
-#ifndef __STDC_FORMAT_MACROS
-#define __STDC_FORMAT_MACROS
-#endif
-
-#include <assert.h>
-#include <inttypes.h>
-#include <stdbool.h>
-
-#ifdef __cplusplus
-#define DART_EXTERN_C extern "C"
-#else
-#define DART_EXTERN_C extern
-#endif
-
-#if defined(__CYGWIN__)
-#error Tool chain and platform not supported.
-#elif defined(_WIN32)
-#if defined(DART_SHARED_LIB)
-#define DART_EXPORT DART_EXTERN_C __declspec(dllexport)
-#else
-#define DART_EXPORT DART_EXTERN_C
-#endif
-#else
-#if __GNUC__ >= 4
-#if defined(DART_SHARED_LIB)
-#define DART_EXPORT \
- DART_EXTERN_C __attribute__((visibility("default"))) __attribute((used))
-#else
-#define DART_EXPORT DART_EXTERN_C
-#endif
-#else
-#error Tool chain not supported.
-#endif
-#endif
-
-#if __GNUC__
-#define DART_WARN_UNUSED_RESULT __attribute__((warn_unused_result))
-#elif _MSC_VER
-#define DART_WARN_UNUSED_RESULT _Check_return_
-#else
-#define DART_WARN_UNUSED_RESULT
-#endif
-
-/*
- * =======
- * Handles
- * =======
- */
-
-/**
- * An isolate is the unit of concurrency in Dart. Each isolate has
- * its own memory and thread of control. No state is shared between
- * isolates. Instead, isolates communicate by message passing.
- *
- * Each thread keeps track of its current isolate, which is the
- * isolate which is ready to execute on the current thread. The
- * current isolate may be NULL, in which case no isolate is ready to
- * execute. Most of the Dart apis require there to be a current
- * isolate in order to function without error. The current isolate is
- * set by any call to Dart_CreateIsolateGroup or Dart_EnterIsolate.
- */
-typedef struct _Dart_Isolate* Dart_Isolate;
-typedef struct _Dart_IsolateGroup* Dart_IsolateGroup;
-
-/**
- * An object reference managed by the Dart VM garbage collector.
- *
- * Because the garbage collector may move objects, it is unsafe to
- * refer to objects directly. Instead, we refer to objects through
- * handles, which are known to the garbage collector and updated
- * automatically when the object is moved. Handles should be passed
- * by value (except in cases like out-parameters) and should never be
- * allocated on the heap.
- *
- * Most functions in the Dart Embedding API return a handle. When a
- * function completes normally, this will be a valid handle to an
- * object in the Dart VM heap. This handle may represent the result of
- * the operation or it may be a special valid handle used merely to
- * indicate successful completion. Note that a valid handle may in
- * some cases refer to the null object.
- *
- * --- Error handles ---
- *
- * When a function encounters a problem that prevents it from
- * completing normally, it returns an error handle (See Dart_IsError).
- * An error handle has an associated error message that gives more
- * details about the problem (See Dart_GetError).
- *
- * There are four kinds of error handles that can be produced,
- * depending on what goes wrong:
- *
- * - Api error handles are produced when an api function is misused.
- * This happens when a Dart embedding api function is called with
- * invalid arguments or in an invalid context.
- *
- * - Unhandled exception error handles are produced when, during the
- * execution of Dart code, an exception is thrown but not caught.
- * Prototypically this would occur during a call to Dart_Invoke, but
- * it can occur in any function which triggers the execution of Dart
- * code (for example, Dart_ToString).
- *
- * An unhandled exception error provides access to an exception and
- * stacktrace via the functions Dart_ErrorGetException and
- * Dart_ErrorGetStackTrace.
- *
- * - Compilation error handles are produced when, during the execution
- * of Dart code, a compile-time error occurs. As above, this can
- * occur in any function which triggers the execution of Dart code.
- *
- * - Fatal error handles are produced when the system wants to shut
- * down the current isolate.
- *
- * --- Propagating errors ---
- *
- * When an error handle is returned from the top level invocation of
- * Dart code in a program, the embedder must handle the error as they
- * see fit. Often, the embedder will print the error message produced
- * by Dart_Error and exit the program.
- *
- * When an error is returned while in the body of a native function,
- * it can be propagated up the call stack by calling
- * Dart_PropagateError, Dart_SetReturnValue, or Dart_ThrowException.
- * Errors should be propagated unless there is a specific reason not
- * to. If an error is not propagated then it is ignored. For
- * example, if an unhandled exception error is ignored, that
- * effectively "catches" the unhandled exception. Fatal errors must
- * always be propagated.
- *
- * When an error is propagated, any current scopes created by
- * Dart_EnterScope will be exited.
- *
- * Using Dart_SetReturnValue to propagate an exception is somewhat
- * more convenient than using Dart_PropagateError, and should be
- * preferred for reasons discussed below.
- *
- * Dart_PropagateError and Dart_ThrowException do not return. Instead
- * they transfer control non-locally using a setjmp-like mechanism.
- * This can be inconvenient if you have resources that you need to
- * clean up before propagating the error.
- *
- * When relying on Dart_PropagateError, we often return error handles
- * rather than propagating them from helper functions. Consider the
- * following contrived example:
- *
- * 1 Dart_Handle isLongStringHelper(Dart_Handle arg) {
- * 2 intptr_t* length = 0;
- * 3 result = Dart_StringLength(arg, &length);
- * 4 if (Dart_IsError(result)) {
- * 5 return result;
- * 6 }
- * 7 return Dart_NewBoolean(length > 100);
- * 8 }
- * 9
- * 10 void NativeFunction_isLongString(Dart_NativeArguments args) {
- * 11 Dart_EnterScope();
- * 12 AllocateMyResource();
- * 13 Dart_Handle arg = Dart_GetNativeArgument(args, 0);
- * 14 Dart_Handle result = isLongStringHelper(arg);
- * 15 if (Dart_IsError(result)) {
- * 16 FreeMyResource();
- * 17 Dart_PropagateError(result);
- * 18 abort(); // will not reach here
- * 19 }
- * 20 Dart_SetReturnValue(result);
- * 21 FreeMyResource();
- * 22 Dart_ExitScope();
- * 23 }
- *
- * In this example, we have a native function which calls a helper
- * function to do its work. On line 5, the helper function could call
- * Dart_PropagateError, but that would not give the native function a
- * chance to call FreeMyResource(), causing a leak. Instead, the
- * helper function returns the error handle to the caller, giving the
- * caller a chance to clean up before propagating the error handle.
- *
- * When an error is propagated by calling Dart_SetReturnValue, the
- * native function will be allowed to complete normally and then the
- * exception will be propagated only once the native call
- * returns. This can be convenient, as it allows the C code to clean
- * up normally.
- *
- * The example can be written more simply using Dart_SetReturnValue to
- * propagate the error.
- *
- * 1 Dart_Handle isLongStringHelper(Dart_Handle arg) {
- * 2 intptr_t* length = 0;
- * 3 result = Dart_StringLength(arg, &length);
- * 4 if (Dart_IsError(result)) {
- * 5 return result
- * 6 }
- * 7 return Dart_NewBoolean(length > 100);
- * 8 }
- * 9
- * 10 void NativeFunction_isLongString(Dart_NativeArguments args) {
- * 11 Dart_EnterScope();
- * 12 AllocateMyResource();
- * 13 Dart_Handle arg = Dart_GetNativeArgument(args, 0);
- * 14 Dart_SetReturnValue(isLongStringHelper(arg));
- * 15 FreeMyResource();
- * 16 Dart_ExitScope();
- * 17 }
- *
- * In this example, the call to Dart_SetReturnValue on line 14 will
- * either return the normal return value or the error (potentially
- * generated on line 3). The call to FreeMyResource on line 15 will
- * execute in either case.
- *
- * --- Local and persistent handles ---
- *
- * Local handles are allocated within the current scope (see
- * Dart_EnterScope) and go away when the current scope exits. Unless
- * otherwise indicated, callers should assume that all functions in
- * the Dart embedding api return local handles.
- *
- * Persistent handles are allocated within the current isolate. They
- * can be used to store objects across scopes. Persistent handles have
- * the lifetime of the current isolate unless they are explicitly
- * deallocated (see Dart_DeletePersistentHandle).
- * The type Dart_Handle represents a handle (both local and persistent).
- * The type Dart_PersistentHandle is a Dart_Handle and it is used to
- * document that a persistent handle is expected as a parameter to a call
- * or the return value from a call is a persistent handle.
- *
- * FinalizableHandles are persistent handles which are auto deleted when
- * the object is garbage collected. It is never safe to use these handles
- * unless you know the object is still reachable.
- *
- * WeakPersistentHandles are persistent handles which are automatically set
- * to point Dart_Null when the object is garbage collected. They are not auto
- * deleted, so it is safe to use them after the object has become unreachable.
- */
-typedef struct _Dart_Handle* Dart_Handle;
-typedef Dart_Handle Dart_PersistentHandle;
-typedef struct _Dart_WeakPersistentHandle* Dart_WeakPersistentHandle;
-typedef struct _Dart_FinalizableHandle* Dart_FinalizableHandle;
-// These structs are versioned by DART_API_DL_MAJOR_VERSION, bump the
-// version when changing this struct.
-
-typedef void (*Dart_HandleFinalizer)(void* isolate_callback_data, void* peer);
-
-/**
- * Is this an error handle?
- *
- * Requires there to be a current isolate.
- */
-DART_EXPORT bool Dart_IsError(Dart_Handle handle);
-
-/**
- * Is this an api error handle?
- *
- * Api error handles are produced when an api function is misused.
- * This happens when a Dart embedding api function is called with
- * invalid arguments or in an invalid context.
- *
- * Requires there to be a current isolate.
- */
-DART_EXPORT bool Dart_IsApiError(Dart_Handle handle);
-
-/**
- * Is this an unhandled exception error handle?
- *
- * Unhandled exception error handles are produced when, during the
- * execution of Dart code, an exception is thrown but not caught.
- * This can occur in any function which triggers the execution of Dart
- * code.
- *
- * See Dart_ErrorGetException and Dart_ErrorGetStackTrace.
- *
- * Requires there to be a current isolate.
- */
-DART_EXPORT bool Dart_IsUnhandledExceptionError(Dart_Handle handle);
-
-/**
- * Is this a compilation error handle?
- *
- * Compilation error handles are produced when, during the execution
- * of Dart code, a compile-time error occurs. This can occur in any
- * function which triggers the execution of Dart code.
- *
- * Requires there to be a current isolate.
- */
-DART_EXPORT bool Dart_IsCompilationError(Dart_Handle handle);
-
-/**
- * Is this a fatal error handle?
- *
- * Fatal error handles are produced when the system wants to shut down
- * the current isolate.
- *
- * Requires there to be a current isolate.
- */
-DART_EXPORT bool Dart_IsFatalError(Dart_Handle handle);
-
-/**
- * Gets the error message from an error handle.
- *
- * Requires there to be a current isolate.
- *
- * \return A C string containing an error message if the handle is
- * error. An empty C string ("") if the handle is valid. This C
- * String is scope allocated and is only valid until the next call
- * to Dart_ExitScope.
-*/
-DART_EXPORT const char* Dart_GetError(Dart_Handle handle);
-
-/**
- * Is this an error handle for an unhandled exception?
- */
-DART_EXPORT bool Dart_ErrorHasException(Dart_Handle handle);
-
-/**
- * Gets the exception Object from an unhandled exception error handle.
- */
-DART_EXPORT Dart_Handle Dart_ErrorGetException(Dart_Handle handle);
-
-/**
- * Gets the stack trace Object from an unhandled exception error handle.
- */
-DART_EXPORT Dart_Handle Dart_ErrorGetStackTrace(Dart_Handle handle);
-
-/**
- * Produces an api error handle with the provided error message.
- *
- * Requires there to be a current isolate.
- *
- * \param error the error message.
- */
-DART_EXPORT Dart_Handle Dart_NewApiError(const char* error);
-DART_EXPORT Dart_Handle Dart_NewCompilationError(const char* error);
-
-/**
- * Produces a new unhandled exception error handle.
- *
- * Requires there to be a current isolate.
- *
- * \param exception An instance of a Dart object to be thrown or
- * an ApiError or CompilationError handle.
- * When an ApiError or CompilationError handle is passed in
- * a string object of the error message is created and it becomes
- * the Dart object to be thrown.
- */
-DART_EXPORT Dart_Handle Dart_NewUnhandledExceptionError(Dart_Handle exception);
-
-/**
- * Propagates an error.
- *
- * If the provided handle is an unhandled exception error, this
- * function will cause the unhandled exception to be rethrown. This
- * will proceed in the standard way, walking up Dart frames until an
- * appropriate 'catch' block is found, executing 'finally' blocks,
- * etc.
- *
- * If the error is not an unhandled exception error, we will unwind
- * the stack to the next C frame. Intervening Dart frames will be
- * discarded; specifically, 'finally' blocks will not execute. This
- * is the standard way that compilation errors (and the like) are
- * handled by the Dart runtime.
- *
- * In either case, when an error is propagated any current scopes
- * created by Dart_EnterScope will be exited.
- *
- * See the additional discussion under "Propagating Errors" at the
- * beginning of this file.
- *
- * \param handle An error handle (See Dart_IsError)
- *
- * On success, this function does not return. On failure, the
- * process is terminated.
- */
-DART_EXPORT void Dart_PropagateError(Dart_Handle handle);
-
-/**
- * Converts an object to a string.
- *
- * May generate an unhandled exception error.
- *
- * \return The converted string if no error occurs during
- * the conversion. If an error does occur, an error handle is
- * returned.
- */
-DART_EXPORT Dart_Handle Dart_ToString(Dart_Handle object);
-
-/**
- * Checks to see if two handles refer to identically equal objects.
- *
- * If both handles refer to instances, this is equivalent to using the top-level
- * function identical() from dart:core. Otherwise, returns whether the two
- * argument handles refer to the same object.
- *
- * \param obj1 An object to be compared.
- * \param obj2 An object to be compared.
- *
- * \return True if the objects are identically equal. False otherwise.
- */
-DART_EXPORT bool Dart_IdentityEquals(Dart_Handle obj1, Dart_Handle obj2);
-
-/**
- * Allocates a handle in the current scope from a persistent handle.
- */
-DART_EXPORT Dart_Handle Dart_HandleFromPersistent(Dart_PersistentHandle object);
-
-/**
- * Allocates a handle in the current scope from a weak persistent handle.
- *
- * This will be a handle to Dart_Null if the object has been garbage collected.
- */
-DART_EXPORT Dart_Handle
-Dart_HandleFromWeakPersistent(Dart_WeakPersistentHandle object);
-
-/**
- * Allocates a persistent handle for an object.
- *
- * This handle has the lifetime of the current isolate unless it is
- * explicitly deallocated by calling Dart_DeletePersistentHandle.
- *
- * Requires there to be a current isolate.
- */
-DART_EXPORT Dart_PersistentHandle Dart_NewPersistentHandle(Dart_Handle object);
-
-/**
- * Assign value of local handle to a persistent handle.
- *
- * Requires there to be a current isolate.
- *
- * \param obj1 A persistent handle whose value needs to be set.
- * \param obj2 An object whose value needs to be set to the persistent handle.
- */
-DART_EXPORT void Dart_SetPersistentHandle(Dart_PersistentHandle obj1,
- Dart_Handle obj2);
-
-/**
- * Deallocates a persistent handle.
- *
- * Requires there to be a current isolate group.
- */
-DART_EXPORT void Dart_DeletePersistentHandle(Dart_PersistentHandle object);
-
-/**
- * Allocates a weak persistent handle for an object.
- *
- * This handle has the lifetime of the current isolate. The handle can also be
- * explicitly deallocated by calling Dart_DeleteWeakPersistentHandle.
- *
- * If the object becomes unreachable the callback is invoked with the peer as
- * argument. The callback can be executed on any thread, will have a current
- * isolate group, but will not have a current isolate. The callback can only
- * call Dart_DeletePersistentHandle or Dart_DeleteWeakPersistentHandle. This
- * gives the embedder the ability to cleanup data associated with the object.
- * The handle will point to the Dart_Null object after the finalizer has been
- * run. It is illegal to call into the VM with any other Dart_* functions from
- * the callback. If the handle is deleted before the object becomes
- * unreachable, the callback is never invoked.
- *
- * Requires there to be a current isolate.
- *
- * \param object An object with identity.
- * \param peer A pointer to a native object or NULL. This value is
- * provided to callback when it is invoked.
- * \param external_allocation_size The number of externally allocated
- * bytes for peer. Used to inform the garbage collector.
- * \param callback A function pointer that will be invoked sometime
- * after the object is garbage collected, unless the handle has been deleted.
- * A valid callback needs to be specified it cannot be NULL.
- *
- * \return The weak persistent handle or NULL. NULL is returned in case of bad
- * parameters.
- */
-DART_EXPORT Dart_WeakPersistentHandle
-Dart_NewWeakPersistentHandle(Dart_Handle object,
- void* peer,
- intptr_t external_allocation_size,
- Dart_HandleFinalizer callback);
-
-/**
- * Deletes the given weak persistent [object] handle.
- *
- * Requires there to be a current isolate group.
- */
-DART_EXPORT void Dart_DeleteWeakPersistentHandle(
- Dart_WeakPersistentHandle object);
-
-/**
- * Updates the external memory size for the given weak persistent handle.
- *
- * May trigger garbage collection.
- */
-DART_EXPORT void Dart_UpdateExternalSize(Dart_WeakPersistentHandle object,
- intptr_t external_allocation_size);
-
-/**
- * Allocates a finalizable handle for an object.
- *
- * This handle has the lifetime of the current isolate group unless the object
- * pointed to by the handle is garbage collected, in this case the VM
- * automatically deletes the handle after invoking the callback associated
- * with the handle. The handle can also be explicitly deallocated by
- * calling Dart_DeleteFinalizableHandle.
- *
- * If the object becomes unreachable the callback is invoked with the
- * the peer as argument. The callback can be executed on any thread, will have
- * an isolate group, but will not have a current isolate. The callback can only
- * call Dart_DeletePersistentHandle or Dart_DeleteWeakPersistentHandle.
- * This gives the embedder the ability to cleanup data associated with the
- * object and clear out any cached references to the handle. All references to
- * this handle after the callback will be invalid. It is illegal to call into
- * the VM with any other Dart_* functions from the callback. If the handle is
- * deleted before the object becomes unreachable, the callback is never
- * invoked.
- *
- * Requires there to be a current isolate.
- *
- * \param object An object with identity.
- * \param peer A pointer to a native object or NULL. This value is
- * provided to callback when it is invoked.
- * \param external_allocation_size The number of externally allocated
- * bytes for peer. Used to inform the garbage collector.
- * \param callback A function pointer that will be invoked sometime
- * after the object is garbage collected, unless the handle has been deleted.
- * A valid callback needs to be specified it cannot be NULL.
- *
- * \return The finalizable handle or NULL. NULL is returned in case of bad
- * parameters.
- */
-DART_EXPORT Dart_FinalizableHandle
-Dart_NewFinalizableHandle(Dart_Handle object,
- void* peer,
- intptr_t external_allocation_size,
- Dart_HandleFinalizer callback);
-
-/**
- * Deletes the given finalizable [object] handle.
- *
- * The caller has to provide the actual Dart object the handle was created from
- * to prove the object (and therefore the finalizable handle) is still alive.
- *
- * Requires there to be a current isolate.
- */
-DART_EXPORT void Dart_DeleteFinalizableHandle(Dart_FinalizableHandle object,
- Dart_Handle strong_ref_to_object);
-
-/**
- * Updates the external memory size for the given finalizable handle.
- *
- * The caller has to provide the actual Dart object the handle was created from
- * to prove the object (and therefore the finalizable handle) is still alive.
- *
- * May trigger garbage collection.
- */
-DART_EXPORT void Dart_UpdateFinalizableExternalSize(
- Dart_FinalizableHandle object,
- Dart_Handle strong_ref_to_object,
- intptr_t external_allocation_size);
-
-/*
- * ==========================
- * Initialization and Globals
- * ==========================
- */
-
-/**
- * Gets the version string for the Dart VM.
- *
- * The version of the Dart VM can be accessed without initializing the VM.
- *
- * \return The version string for the embedded Dart VM.
- */
-DART_EXPORT const char* Dart_VersionString(void);
-
-/**
- * Isolate specific flags are set when creating a new isolate using the
- * Dart_IsolateFlags structure.
- *
- * Current version of flags is encoded in a 32-bit integer with 16 bits used
- * for each part.
- */
-
-#define DART_FLAGS_CURRENT_VERSION (0x0000000c)
-
-typedef struct {
- int32_t version;
- bool enable_asserts;
- bool use_field_guards;
- bool use_osr;
- bool obfuscate;
- bool load_vmservice_library;
- bool copy_parent_code;
- bool null_safety;
- bool is_system_isolate;
- bool snapshot_is_dontneed_safe;
- bool branch_coverage;
-} Dart_IsolateFlags;
-
-/**
- * Initialize Dart_IsolateFlags with correct version and default values.
- */
-DART_EXPORT void Dart_IsolateFlagsInitialize(Dart_IsolateFlags* flags);
-
-/**
- * An isolate creation and initialization callback function.
- *
- * This callback, provided by the embedder, is called when the VM
- * needs to create an isolate. The callback should create an isolate
- * by calling Dart_CreateIsolateGroup and load any scripts required for
- * execution.
- *
- * This callback may be called on a different thread than the one
- * running the parent isolate.
- *
- * When the function returns NULL, it is the responsibility of this
- * function to ensure that Dart_ShutdownIsolate has been called if
- * required (for example, if the isolate was created successfully by
- * Dart_CreateIsolateGroup() but the root library fails to load
- * successfully, then the function should call Dart_ShutdownIsolate
- * before returning).
- *
- * When the function returns NULL, the function should set *error to
- * a malloc-allocated buffer containing a useful error message. The
- * caller of this function (the VM) will make sure that the buffer is
- * freed.
- *
- * \param script_uri The uri of the main source file or snapshot to load.
- * Either the URI of the parent isolate set in Dart_CreateIsolateGroup for
- * Isolate.spawn, or the argument to Isolate.spawnUri canonicalized by the
- * library tag handler of the parent isolate.
- * The callback is responsible for loading the program by a call to
- * Dart_LoadScriptFromKernel.
- * \param main The name of the main entry point this isolate will
- * eventually run. This is provided for advisory purposes only to
- * improve debugging messages. The main function is not invoked by
- * this function.
- * \param package_root Ignored.
- * \param package_config Uri of the package configuration file (either in format
- * of .packages or .dart_tool/package_config.json) for this isolate
- * to resolve package imports against. If this parameter is not passed the
- * package resolution of the parent isolate should be used.
- * \param flags Default flags for this isolate being spawned. Either inherited
- * from the spawning isolate or passed as parameters when spawning the
- * isolate from Dart code.
- * \param isolate_data The isolate data which was passed to the
- * parent isolate when it was created by calling Dart_CreateIsolateGroup().
- * \param error A structure into which the embedder can place a
- * C string containing an error message in the case of failures.
- *
- * \return The embedder returns NULL if the creation and
- * initialization was not successful and the isolate if successful.
- */
-typedef Dart_Isolate (*Dart_IsolateGroupCreateCallback)(
- const char* script_uri,
- const char* main,
- const char* package_root,
- const char* package_config,
- Dart_IsolateFlags* flags,
- void* isolate_data,
- char** error);
-
-/**
- * An isolate initialization callback function.
- *
- * This callback, provided by the embedder, is called when the VM has created an
- * isolate within an existing isolate group (i.e. from the same source as an
- * existing isolate).
- *
- * The callback should setup native resolvers and might want to set a custom
- * message handler via [Dart_SetMessageNotifyCallback] and mark the isolate as
- * runnable.
- *
- * This callback may be called on a different thread than the one
- * running the parent isolate.
- *
- * When the function returns `false`, it is the responsibility of this
- * function to ensure that `Dart_ShutdownIsolate` has been called.
- *
- * When the function returns `false`, the function should set *error to
- * a malloc-allocated buffer containing a useful error message. The
- * caller of this function (the VM) will make sure that the buffer is
- * freed.
- *
- * \param child_isolate_data The callback data to associate with the new
- * child isolate.
- * \param error A structure into which the embedder can place a
- * C string containing an error message in the case the initialization fails.
- *
- * \return The embedder returns true if the initialization was successful and
- * false otherwise (in which case the VM will terminate the isolate).
- */
-typedef bool (*Dart_InitializeIsolateCallback)(void** child_isolate_data,
- char** error);
-
-/**
- * An isolate shutdown callback function.
- *
- * This callback, provided by the embedder, is called before the vm
- * shuts down an isolate. The isolate being shutdown will be the current
- * isolate. It is safe to run Dart code.
- *
- * This function should be used to dispose of native resources that
- * are allocated to an isolate in order to avoid leaks.
- *
- * \param isolate_group_data The same callback data which was passed to the
- * isolate group when it was created.
- * \param isolate_data The same callback data which was passed to the isolate
- * when it was created.
- */
-typedef void (*Dart_IsolateShutdownCallback)(void* isolate_group_data,
- void* isolate_data);
-
-/**
- * An isolate cleanup callback function.
- *
- * This callback, provided by the embedder, is called after the vm
- * shuts down an isolate. There will be no current isolate and it is *not*
- * safe to run Dart code.
- *
- * This function should be used to dispose of native resources that
- * are allocated to an isolate in order to avoid leaks.
- *
- * \param isolate_group_data The same callback data which was passed to the
- * isolate group when it was created.
- * \param isolate_data The same callback data which was passed to the isolate
- * when it was created.
- */
-typedef void (*Dart_IsolateCleanupCallback)(void* isolate_group_data,
- void* isolate_data);
-
-/**
- * An isolate group cleanup callback function.
- *
- * This callback, provided by the embedder, is called after the vm
- * shuts down an isolate group.
- *
- * This function should be used to dispose of native resources that
- * are allocated to an isolate in order to avoid leaks.
- *
- * \param isolate_group_data The same callback data which was passed to the
- * isolate group when it was created.
- *
- */
-typedef void (*Dart_IsolateGroupCleanupCallback)(void* isolate_group_data);
-
-/**
- * A thread start callback function.
- * This callback, provided by the embedder, is called after a thread in the
- * vm thread pool starts.
- * This function could be used to adjust thread priority or attach native
- * resources to the thread.
- */
-typedef void (*Dart_ThreadStartCallback)(void);
-
-/**
- * A thread death callback function.
- * This callback, provided by the embedder, is called before a thread in the
- * vm thread pool exits.
- * This function could be used to dispose of native resources that
- * are associated and attached to the thread, in order to avoid leaks.
- */
-typedef void (*Dart_ThreadExitCallback)(void);
-
-/**
- * Opens a file for reading or writing.
- *
- * Callback provided by the embedder for file operations. If the
- * embedder does not allow file operations this callback can be
- * NULL.
- *
- * \param name The name of the file to open.
- * \param write A boolean variable which indicates if the file is to
- * opened for writing. If there is an existing file it needs to truncated.
- */
-typedef void* (*Dart_FileOpenCallback)(const char* name, bool write);
-
-/**
- * Read contents of file.
- *
- * Callback provided by the embedder for file operations. If the
- * embedder does not allow file operations this callback can be
- * NULL.
- *
- * \param data Buffer allocated in the callback into which the contents
- * of the file are read into. It is the responsibility of the caller to
- * free this buffer.
- * \param file_length A variable into which the length of the file is returned.
- * In the case of an error this value would be -1.
- * \param stream Handle to the opened file.
- */
-typedef void (*Dart_FileReadCallback)(uint8_t** data,
- intptr_t* file_length,
- void* stream);
-
-/**
- * Write data into file.
- *
- * Callback provided by the embedder for file operations. If the
- * embedder does not allow file operations this callback can be
- * NULL.
- *
- * \param data Buffer which needs to be written into the file.
- * \param length Length of the buffer.
- * \param stream Handle to the opened file.
- */
-typedef void (*Dart_FileWriteCallback)(const void* data,
- intptr_t length,
- void* stream);
-
-/**
- * Closes the opened file.
- *
- * Callback provided by the embedder for file operations. If the
- * embedder does not allow file operations this callback can be
- * NULL.
- *
- * \param stream Handle to the opened file.
- */
-typedef void (*Dart_FileCloseCallback)(void* stream);
-
-typedef bool (*Dart_EntropySource)(uint8_t* buffer, intptr_t length);
-
-/**
- * Callback provided by the embedder that is used by the vmservice isolate
- * to request the asset archive. The asset archive must be an uncompressed tar
- * archive that is stored in a Uint8List.
- *
- * If the embedder has no vmservice isolate assets, the callback can be NULL.
- *
- * \return The embedder must return a handle to a Uint8List containing an
- * uncompressed tar archive or null.
- */
-typedef Dart_Handle (*Dart_GetVMServiceAssetsArchive)(void);
-
-/**
- * The current version of the Dart_InitializeFlags. Should be incremented every
- * time Dart_InitializeFlags changes in a binary incompatible way.
- */
-#define DART_INITIALIZE_PARAMS_CURRENT_VERSION (0x00000007)
-
-/** Forward declaration */
-struct Dart_CodeObserver;
-
-/**
- * Callback provided by the embedder that is used by the VM to notify on code
- * object creation, *before* it is invoked the first time.
- * This is useful for embedders wanting to e.g. keep track of PCs beyond
- * the lifetime of the garbage collected code objects.
- * Note that an address range may be used by more than one code object over the
- * lifecycle of a process. Clients of this function should record timestamps for
- * these compilation events and when collecting PCs to disambiguate reused
- * address ranges.
- */
-typedef void (*Dart_OnNewCodeCallback)(struct Dart_CodeObserver* observer,
- const char* name,
- uintptr_t base,
- uintptr_t size);
-
-typedef struct Dart_CodeObserver {
- void* data;
-
- Dart_OnNewCodeCallback on_new_code;
-} Dart_CodeObserver;
-
-/**
- * Optional callback provided by the embedder that is used by the VM to
- * implement registration of kernel blobs for the subsequent Isolate.spawnUri
- * If no callback is provided, the registration of kernel blobs will throw
- * an error.
- *
- * \param kernel_buffer A buffer which contains a kernel program. Callback
- * should copy the contents of `kernel_buffer` as
- * it may be freed immediately after registration.
- * \param kernel_buffer_size The size of `kernel_buffer`.
- *
- * \return A C string representing URI which can be later used
- * to spawn a new isolate. This C String should be scope allocated
- * or owned by the embedder.
- * Returns NULL if embedder runs out of memory.
- */
-typedef const char* (*Dart_RegisterKernelBlobCallback)(
- const uint8_t* kernel_buffer,
- intptr_t kernel_buffer_size);
-
-/**
- * Optional callback provided by the embedder that is used by the VM to
- * unregister kernel blobs.
- * If no callback is provided, the unregistration of kernel blobs will throw
- * an error.
- *
- * \param kernel_blob_uri URI of the kernel blob to unregister.
- */
-typedef void (*Dart_UnregisterKernelBlobCallback)(const char* kernel_blob_uri);
-
-/**
- * Describes how to initialize the VM. Used with Dart_Initialize.
- */
-typedef struct {
- /**
- * Identifies the version of the struct used by the client.
- * should be initialized to DART_INITIALIZE_PARAMS_CURRENT_VERSION.
- */
- int32_t version;
-
- /**
- * A buffer containing snapshot data, or NULL if no snapshot is provided.
- *
- * If provided, the buffer must remain valid until Dart_Cleanup returns.
- */
- const uint8_t* vm_snapshot_data;
-
- /**
- * A buffer containing a snapshot of precompiled instructions, or NULL if
- * no snapshot is provided.
- *
- * If provided, the buffer must remain valid until Dart_Cleanup returns.
- */
- const uint8_t* vm_snapshot_instructions;
-
- /**
- * A function to be called during isolate group creation.
- * See Dart_IsolateGroupCreateCallback.
- */
- Dart_IsolateGroupCreateCallback create_group;
-
- /**
- * A function to be called during isolate
- * initialization inside an existing isolate group.
- * See Dart_InitializeIsolateCallback.
- */
- Dart_InitializeIsolateCallback initialize_isolate;
-
- /**
- * A function to be called right before an isolate is shutdown.
- * See Dart_IsolateShutdownCallback.
- */
- Dart_IsolateShutdownCallback shutdown_isolate;
-
- /**
- * A function to be called after an isolate was shutdown.
- * See Dart_IsolateCleanupCallback.
- */
- Dart_IsolateCleanupCallback cleanup_isolate;
-
- /**
- * A function to be called after an isolate group is
- * shutdown. See Dart_IsolateGroupCleanupCallback.
- */
- Dart_IsolateGroupCleanupCallback cleanup_group;
-
- Dart_ThreadStartCallback thread_start;
- Dart_ThreadExitCallback thread_exit;
- Dart_FileOpenCallback file_open;
- Dart_FileReadCallback file_read;
- Dart_FileWriteCallback file_write;
- Dart_FileCloseCallback file_close;
- Dart_EntropySource entropy_source;
-
- /**
- * A function to be called by the service isolate when it requires the
- * vmservice assets archive. See Dart_GetVMServiceAssetsArchive.
- */
- Dart_GetVMServiceAssetsArchive get_service_assets;
-
- bool start_kernel_isolate;
-
- /**
- * An external code observer callback function. The observer can be invoked
- * as early as during the Dart_Initialize() call.
- */
- Dart_CodeObserver* code_observer;
-
- /**
- * Kernel blob registration callback function. See Dart_RegisterKernelBlobCallback.
- */
- Dart_RegisterKernelBlobCallback register_kernel_blob;
-
- /**
- * Kernel blob unregistration callback function. See Dart_UnregisterKernelBlobCallback.
- */
- Dart_UnregisterKernelBlobCallback unregister_kernel_blob;
-} Dart_InitializeParams;
-
-/**
- * Initializes the VM.
- *
- * \param params A struct containing initialization information. The version
- * field of the struct must be DART_INITIALIZE_PARAMS_CURRENT_VERSION.
- *
- * \return NULL if initialization is successful. Returns an error message
- * otherwise. The caller is responsible for freeing the error message.
- */
-DART_EXPORT DART_WARN_UNUSED_RESULT char* Dart_Initialize(
- Dart_InitializeParams* params);
-
-/**
- * Cleanup state in the VM before process termination.
- *
- * \return NULL if cleanup is successful. Returns an error message otherwise.
- * The caller is responsible for freeing the error message.
- *
- * NOTE: This function must not be called on a thread that was created by the VM
- * itself.
- */
-DART_EXPORT DART_WARN_UNUSED_RESULT char* Dart_Cleanup(void);
-
-/**
- * Sets command line flags. Should be called before Dart_Initialize.
- *
- * \param argc The length of the arguments array.
- * \param argv An array of arguments.
- *
- * \return NULL if successful. Returns an error message otherwise.
- * The caller is responsible for freeing the error message.
- *
- * NOTE: This call does not store references to the passed in c-strings.
- */
-DART_EXPORT DART_WARN_UNUSED_RESULT char* Dart_SetVMFlags(int argc,
- const char** argv);
-
-/**
- * Returns true if the named VM flag is of boolean type, specified, and set to
- * true.
- *
- * \param flag_name The name of the flag without leading punctuation
- * (example: "enable_asserts").
- */
-DART_EXPORT bool Dart_IsVMFlagSet(const char* flag_name);
-
-/*
- * ========
- * Isolates
- * ========
- */
-
-/**
- * Creates a new isolate. The new isolate becomes the current isolate.
- *
- * A snapshot can be used to restore the VM quickly to a saved state
- * and is useful for fast startup. If snapshot data is provided, the
- * isolate will be started using that snapshot data. Requires a core snapshot or
- * an app snapshot created by Dart_CreateSnapshot or
- * Dart_CreatePrecompiledSnapshot* from a VM with the same version.
- *
- * Requires there to be no current isolate.
- *
- * \param script_uri The main source file or snapshot this isolate will load.
- * The VM will provide this URI to the Dart_IsolateGroupCreateCallback when a
- * child isolate is created by Isolate.spawn. The embedder should use a URI
- * that allows it to load the same program into such a child isolate.
- * \param name A short name for the isolate to improve debugging messages.
- * Typically of the format 'foo.dart:main()'.
- * \param isolate_snapshot_data Buffer containing the snapshot data of the
- * isolate or NULL if no snapshot is provided. If provided, the buffer must
- * remain valid until the isolate shuts down.
- * \param isolate_snapshot_instructions Buffer containing the snapshot
- * instructions of the isolate or NULL if no snapshot is provided. If
- * provided, the buffer must remain valid until the isolate shuts down.
- * \param flags Pointer to VM specific flags or NULL for default flags.
- * \param isolate_group_data Embedder group data. This data can be obtained
- * by calling Dart_IsolateGroupData and will be passed to the
- * Dart_IsolateShutdownCallback, Dart_IsolateCleanupCallback, and
- * Dart_IsolateGroupCleanupCallback.
- * \param isolate_data Embedder data. This data will be passed to
- * the Dart_IsolateGroupCreateCallback when new isolates are spawned from
- * this parent isolate.
- * \param error Returns NULL if creation is successful, an error message
- * otherwise. The caller is responsible for calling free() on the error
- * message.
- *
- * \return The new isolate on success, or NULL if isolate creation failed.
- */
-DART_EXPORT Dart_Isolate
-Dart_CreateIsolateGroup(const char* script_uri,
- const char* name,
- const uint8_t* isolate_snapshot_data,
- const uint8_t* isolate_snapshot_instructions,
- Dart_IsolateFlags* flags,
- void* isolate_group_data,
- void* isolate_data,
- char** error);
-/**
- * Creates a new isolate inside the isolate group of [group_member].
- *
- * Requires there to be no current isolate.
- *
- * \param group_member An isolate from the same group into which the newly created
- * isolate should be born into. Other threads may not have entered / enter this
- * member isolate.
- * \param name A short name for the isolate for debugging purposes.
- * \param shutdown_callback A callback to be called when the isolate is being
- * shutdown (may be NULL).
- * \param cleanup_callback A callback to be called when the isolate is being
- * cleaned up (may be NULL).
- * \param isolate_data The embedder-specific data associated with this isolate.
- * \param error Set to NULL if creation is successful, set to an error
- * message otherwise. The caller is responsible for calling free() on the
- * error message.
- *
- * \return The newly created isolate on success, or NULL if isolate creation
- * failed.
- *
- * If successful, the newly created isolate will become the current isolate.
- */
-DART_EXPORT Dart_Isolate
-Dart_CreateIsolateInGroup(Dart_Isolate group_member,
- const char* name,
- Dart_IsolateShutdownCallback shutdown_callback,
- Dart_IsolateCleanupCallback cleanup_callback,
- void* child_isolate_data,
- char** error);
-
-/* TODO(turnidge): Document behavior when there is already a current
- * isolate. */
-
-/**
- * Creates a new isolate from a Dart Kernel file. The new isolate
- * becomes the current isolate.
- *
- * Requires there to be no current isolate.
- *
- * \param script_uri The main source file or snapshot this isolate will load.
- * The VM will provide this URI to the Dart_IsolateGroupCreateCallback when a
- * child isolate is created by Isolate.spawn. The embedder should use a URI that
- * allows it to load the same program into such a child isolate.
- * \param name A short name for the isolate to improve debugging messages.
- * Typically of the format 'foo.dart:main()'.
- * \param kernel_buffer A buffer which contains a kernel/DIL program. Must
- * remain valid until isolate shutdown.
- * \param kernel_buffer_size The size of `kernel_buffer`.
- * \param flags Pointer to VM specific flags or NULL for default flags.
- * \param isolate_group_data Embedder group data. This data can be obtained
- * by calling Dart_IsolateGroupData and will be passed to the
- * Dart_IsolateShutdownCallback, Dart_IsolateCleanupCallback, and
- * Dart_IsolateGroupCleanupCallback.
- * \param isolate_data Embedder data. This data will be passed to
- * the Dart_IsolateGroupCreateCallback when new isolates are spawned from
- * this parent isolate.
- * \param error Returns NULL if creation is successful, an error message
- * otherwise. The caller is responsible for calling free() on the error
- * message.
- *
- * \return The new isolate on success, or NULL if isolate creation failed.
- */
-DART_EXPORT Dart_Isolate
-Dart_CreateIsolateGroupFromKernel(const char* script_uri,
- const char* name,
- const uint8_t* kernel_buffer,
- intptr_t kernel_buffer_size,
- Dart_IsolateFlags* flags,
- void* isolate_group_data,
- void* isolate_data,
- char** error);
-/**
- * Shuts down the current isolate. After this call, the current isolate is NULL.
- * Any current scopes created by Dart_EnterScope will be exited. Invokes the
- * shutdown callback and any callbacks of remaining weak persistent handles.
- *
- * Requires there to be a current isolate.
- */
-DART_EXPORT void Dart_ShutdownIsolate(void);
-/* TODO(turnidge): Document behavior when there is no current isolate. */
-
-/**
- * Returns the current isolate. Will return NULL if there is no
- * current isolate.
- */
-DART_EXPORT Dart_Isolate Dart_CurrentIsolate(void);
-
-/**
- * Returns the callback data associated with the current isolate. This
- * data was set when the isolate got created or initialized.
- */
-DART_EXPORT void* Dart_CurrentIsolateData(void);
-
-/**
- * Returns the callback data associated with the given isolate. This
- * data was set when the isolate got created or initialized.
- */
-DART_EXPORT void* Dart_IsolateData(Dart_Isolate isolate);
-
-/**
- * Returns the current isolate group. Will return NULL if there is no
- * current isolate group.
- */
-DART_EXPORT Dart_IsolateGroup Dart_CurrentIsolateGroup(void);
-
-/**
- * Returns the callback data associated with the current isolate group. This
- * data was passed to the isolate group when it was created.
- */
-DART_EXPORT void* Dart_CurrentIsolateGroupData(void);
-
-/**
- * Gets an id that uniquely identifies current isolate group.
- *
- * It is the responsibility of the caller to free the returned ID.
- */
-typedef int64_t Dart_IsolateGroupId;
-DART_EXPORT Dart_IsolateGroupId Dart_CurrentIsolateGroupId();
-
-/**
- * Returns the callback data associated with the specified isolate group. This
- * data was passed to the isolate when it was created.
- * The embedder is responsible for ensuring the consistency of this data
- * with respect to the lifecycle of an isolate group.
- */
-DART_EXPORT void* Dart_IsolateGroupData(Dart_Isolate isolate);
-
-/**
- * Returns the debugging name for the current isolate.
- *
- * This name is unique to each isolate and should only be used to make
- * debugging messages more comprehensible.
- */
-DART_EXPORT Dart_Handle Dart_DebugName(void);
-
-/**
- * Returns the ID for an isolate which is used to query the service protocol.
- *
- * It is the responsibility of the caller to free the returned ID.
- */
-DART_EXPORT const char* Dart_IsolateServiceId(Dart_Isolate isolate);
-
-/**
- * Enters an isolate. After calling this function,
- * the current isolate will be set to the provided isolate.
- *
- * Requires there to be no current isolate. Multiple threads may not be in
- * the same isolate at once.
- */
-DART_EXPORT void Dart_EnterIsolate(Dart_Isolate isolate);
-
-/**
- * Kills the given isolate.
- *
- * This function has the same effect as dart:isolate's
- * Isolate.kill(priority:immediate).
- * It can interrupt ordinary Dart code but not native code. If the isolate is
- * in the middle of a long running native function, the isolate will not be
- * killed until control returns to Dart.
- *
- * Does not require a current isolate. It is safe to kill the current isolate if
- * there is one.
- */
-DART_EXPORT void Dart_KillIsolate(Dart_Isolate isolate);
-
-/**
- * Notifies the VM that the embedder expects to be idle until |deadline|. The VM
- * may use this time to perform garbage collection or other tasks to avoid
- * delays during execution of Dart code in the future.
- *
- * |deadline| is measured in microseconds against the system's monotonic time.
- * This clock can be accessed via Dart_TimelineGetMicros().
- *
- * Requires there to be a current isolate.
- */
-DART_EXPORT void Dart_NotifyIdle(int64_t deadline);
-
-/**
- * Notifies the VM that the embedder expects the application's working set has
- * recently shrunk significantly and is not expected to rise in the near future.
- * The VM may spend O(heap-size) time performing clean up work.
- *
- * Requires there to be a current isolate.
- */
-DART_EXPORT void Dart_NotifyDestroyed(void);
-
-/**
- * Notifies the VM that the system is running low on memory.
- *
- * Does not require a current isolate. Only valid after calling Dart_Initialize.
- */
-DART_EXPORT void Dart_NotifyLowMemory(void);
-
-typedef enum {
- /**
- * Balanced
- */
- Dart_PerformanceMode_Default,
- /**
- * Optimize for low latency, at the expense of throughput and memory overhead
- * by performing work in smaller batches (requiring more overhead) or by
- * delaying work (requiring more memory). An embedder should not remain in
- * this mode indefinitely.
- */
- Dart_PerformanceMode_Latency,
- /**
- * Optimize for high throughput, at the expense of latency and memory overhead
- * by performing work in larger batches with more intervening growth.
- */
- Dart_PerformanceMode_Throughput,
- /**
- * Optimize for low memory, at the expensive of throughput and latency by more
- * frequently performing work.
- */
- Dart_PerformanceMode_Memory,
-} Dart_PerformanceMode;
-
-/**
- * Set the desired performance trade-off.
- *
- * Requires a current isolate.
- *
- * Returns the previous performance mode.
- */
-DART_EXPORT Dart_PerformanceMode
-Dart_SetPerformanceMode(Dart_PerformanceMode mode);
-
-/**
- * Starts the CPU sampling profiler.
- */
-DART_EXPORT void Dart_StartProfiling(void);
-
-/**
- * Stops the CPU sampling profiler.
- *
- * Note that some profile samples might still be taken after this fucntion
- * returns due to the asynchronous nature of the implementation on some
- * platforms.
- */
-DART_EXPORT void Dart_StopProfiling(void);
-
-/**
- * Notifies the VM that the current thread should not be profiled until a
- * matching call to Dart_ThreadEnableProfiling is made.
- *
- * NOTE: By default, if a thread has entered an isolate it will be profiled.
- * This function should be used when an embedder knows a thread is about
- * to make a blocking call and wants to avoid unnecessary interrupts by
- * the profiler.
- */
-DART_EXPORT void Dart_ThreadDisableProfiling(void);
-
-/**
- * Notifies the VM that the current thread should be profiled.
- *
- * NOTE: It is only legal to call this function *after* calling
- * Dart_ThreadDisableProfiling.
- *
- * NOTE: By default, if a thread has entered an isolate it will be profiled.
- */
-DART_EXPORT void Dart_ThreadEnableProfiling(void);
-
-/**
- * Register symbol information for the Dart VM's profiler and crash dumps.
- *
- * This consumes the output of //topaz/runtime/dart/profiler_symbols, which
- * should be treated as opaque.
- */
-DART_EXPORT void Dart_AddSymbols(const char* dso_name,
- void* buffer,
- intptr_t buffer_size);
-
-/**
- * Exits an isolate. After this call, Dart_CurrentIsolate will
- * return NULL.
- *
- * Requires there to be a current isolate.
- */
-DART_EXPORT void Dart_ExitIsolate(void);
-/* TODO(turnidge): We don't want users of the api to be able to exit a
- * "pure" dart isolate. Implement and document. */
-
-/**
- * Creates a full snapshot of the current isolate heap.
- *
- * A full snapshot is a compact representation of the dart vm isolate heap
- * and dart isolate heap states. These snapshots are used to initialize
- * the vm isolate on startup and fast initialization of an isolate.
- * A Snapshot of the heap is created before any dart code has executed.
- *
- * Requires there to be a current isolate. Not available in the precompiled
- * runtime (check Dart_IsPrecompiledRuntime).
- *
- * \param vm_snapshot_data_buffer Returns a pointer to a buffer containing the
- * vm snapshot. This buffer is scope allocated and is only valid
- * until the next call to Dart_ExitScope.
- * \param vm_snapshot_data_size Returns the size of vm_snapshot_data_buffer.
- * \param isolate_snapshot_data_buffer Returns a pointer to a buffer containing
- * the isolate snapshot. This buffer is scope allocated and is only valid
- * until the next call to Dart_ExitScope.
- * \param isolate_snapshot_data_size Returns the size of
- * isolate_snapshot_data_buffer.
- * \param is_core Create a snapshot containing core libraries.
- * Such snapshot should be agnostic to null safety mode.
- *
- * \return A valid handle if no error occurs during the operation.
- */
-DART_EXPORT DART_WARN_UNUSED_RESULT Dart_Handle
-Dart_CreateSnapshot(uint8_t** vm_snapshot_data_buffer,
- intptr_t* vm_snapshot_data_size,
- uint8_t** isolate_snapshot_data_buffer,
- intptr_t* isolate_snapshot_data_size,
- bool is_core);
-
-/**
- * Returns whether the buffer contains a kernel file.
- *
- * \param buffer Pointer to a buffer that might contain a kernel binary.
- * \param buffer_size Size of the buffer.
- *
- * \return Whether the buffer contains a kernel binary (full or partial).
- */
-DART_EXPORT bool Dart_IsKernel(const uint8_t* buffer, intptr_t buffer_size);
-
-/**
- * Make isolate runnable.
- *
- * When isolates are spawned, this function is used to indicate that
- * the creation and initialization (including script loading) of the
- * isolate is complete and the isolate can start.
- * This function expects there to be no current isolate.
- *
- * \param isolate The isolate to be made runnable.
- *
- * \return NULL if successful. Returns an error message otherwise. The caller
- * is responsible for freeing the error message.
- */
-DART_EXPORT DART_WARN_UNUSED_RESULT char* Dart_IsolateMakeRunnable(
- Dart_Isolate isolate);
-
-/*
- * ==================
- * Messages and Ports
- * ==================
- */
-
-/**
- * A port is used to send or receive inter-isolate messages
- */
-typedef int64_t Dart_Port;
-
-/**
- * ILLEGAL_PORT is a port number guaranteed never to be associated with a valid
- * port.
- */
-#define ILLEGAL_PORT ((Dart_Port)0)
-
-/**
- * A message notification callback.
- *
- * This callback allows the embedder to provide a custom wakeup mechanism for
- * the delivery of inter-isolate messages. This function is called once per
- * message on an arbitrary thread. It is the responsibility of the embedder to
- * eventually call Dart_HandleMessage once per callback received with the
- * destination isolate set as the current isolate to process the message.
- */
-typedef void (*Dart_MessageNotifyCallback)(Dart_Isolate destination_isolate);
-
-/**
- * Allows embedders to provide a custom wakeup mechanism for the delivery of
- * inter-isolate messages. This setting only applies to the current isolate.
- *
- * This mechanism is optional: if not provided, the isolate will be scheduled on
- * a VM-managed thread pool. An embedder should provide this callback if it
- * wants to run an isolate on a specific thread or to interleave handling of
- * inter-isolate messages with other event sources.
- *
- * Most embedders will only call this function once, before isolate
- * execution begins. If this function is called after isolate
- * execution begins, the embedder is responsible for threading issues.
- */
-DART_EXPORT void Dart_SetMessageNotifyCallback(
- Dart_MessageNotifyCallback message_notify_callback);
-/* TODO(turnidge): Consider moving this to isolate creation so that it
- * is impossible to mess up. */
-
-/**
- * Query the current message notify callback for the isolate.
- *
- * \return The current message notify callback for the isolate.
- */
-DART_EXPORT Dart_MessageNotifyCallback Dart_GetMessageNotifyCallback(void);
-
-/**
- * The VM's default message handler supports pausing an isolate before it
- * processes the first message and right after the it processes the isolate's
- * final message. This can be controlled for all isolates by two VM flags:
- *
- * `--pause-isolates-on-start`
- * `--pause-isolates-on-exit`
- *
- * Additionally, Dart_SetShouldPauseOnStart and Dart_SetShouldPauseOnExit can be
- * used to control this behaviour on a per-isolate basis.
- *
- * When an embedder is using a Dart_MessageNotifyCallback the embedder
- * needs to cooperate with the VM so that the service protocol can report
- * accurate information about isolates and so that tools such as debuggers
- * work reliably.
- *
- * The following functions can be used to implement pausing on start and exit.
- */
-
-/**
- * If the VM flag `--pause-isolates-on-start` was passed this will be true.
- *
- * \return A boolean value indicating if pause on start was requested.
- */
-DART_EXPORT bool Dart_ShouldPauseOnStart(void);
-
-/**
- * Override the VM flag `--pause-isolates-on-start` for the current isolate.
- *
- * \param should_pause Should the isolate be paused on start?
- *
- * NOTE: This must be called before Dart_IsolateMakeRunnable.
- */
-DART_EXPORT void Dart_SetShouldPauseOnStart(bool should_pause);
-
-/**
- * Is the current isolate paused on start?
- *
- * \return A boolean value indicating if the isolate is paused on start.
- */
-DART_EXPORT bool Dart_IsPausedOnStart(void);
-
-/**
- * Called when the embedder has paused the current isolate on start and when
- * the embedder has resumed the isolate.
- *
- * \param paused Is the isolate paused on start?
- */
-DART_EXPORT void Dart_SetPausedOnStart(bool paused);
-
-/**
- * If the VM flag `--pause-isolates-on-exit` was passed this will be true.
- *
- * \return A boolean value indicating if pause on exit was requested.
- */
-DART_EXPORT bool Dart_ShouldPauseOnExit(void);
-
-/**
- * Override the VM flag `--pause-isolates-on-exit` for the current isolate.
- *
- * \param should_pause Should the isolate be paused on exit?
- *
- */
-DART_EXPORT void Dart_SetShouldPauseOnExit(bool should_pause);
-
-/**
- * Is the current isolate paused on exit?
- *
- * \return A boolean value indicating if the isolate is paused on exit.
- */
-DART_EXPORT bool Dart_IsPausedOnExit(void);
-
-/**
- * Called when the embedder has paused the current isolate on exit and when
- * the embedder has resumed the isolate.
- *
- * \param paused Is the isolate paused on exit?
- */
-DART_EXPORT void Dart_SetPausedOnExit(bool paused);
-
-/**
- * Called when the embedder has caught a top level unhandled exception error
- * in the current isolate.
- *
- * NOTE: It is illegal to call this twice on the same isolate without first
- * clearing the sticky error to null.
- *
- * \param error The unhandled exception error.
- */
-DART_EXPORT void Dart_SetStickyError(Dart_Handle error);
-
-/**
- * Does the current isolate have a sticky error?
- */
-DART_EXPORT bool Dart_HasStickyError(void);
-
-/**
- * Gets the sticky error for the current isolate.
- *
- * \return A handle to the sticky error object or null.
- */
-DART_EXPORT Dart_Handle Dart_GetStickyError(void);
-
-/**
- * Handles the next pending message for the current isolate.
- *
- * May generate an unhandled exception error.
- *
- * \return A valid handle if no error occurs during the operation.
- */
-DART_EXPORT DART_WARN_UNUSED_RESULT Dart_Handle Dart_HandleMessage(void);
-
-/**
- * Drains the microtask queue, then blocks the calling thread until the current
- * isolate receives a message, then handles all messages.
- *
- * \param timeout_millis When non-zero, the call returns after the indicated
- number of milliseconds even if no message was received.
- * \return A valid handle if no error occurs, otherwise an error handle.
- */
-DART_EXPORT DART_WARN_UNUSED_RESULT Dart_Handle
-Dart_WaitForEvent(int64_t timeout_millis);
-
-/**
- * Handles any pending messages for the vm service for the current
- * isolate.
- *
- * This function may be used by an embedder at a breakpoint to avoid
- * pausing the vm service.
- *
- * This function can indirectly cause the message notify callback to
- * be called.
- *
- * \return true if the vm service requests the program resume
- * execution, false otherwise
- */
-DART_EXPORT bool Dart_HandleServiceMessages(void);
-
-/**
- * Does the current isolate have pending service messages?
- *
- * \return true if the isolate has pending service messages, false otherwise.
- */
-DART_EXPORT bool Dart_HasServiceMessages(void);
-
-/**
- * Processes any incoming messages for the current isolate.
- *
- * This function may only be used when the embedder has not provided
- * an alternate message delivery mechanism with
- * Dart_SetMessageCallbacks. It is provided for convenience.
- *
- * This function waits for incoming messages for the current
- * isolate. As new messages arrive, they are handled using
- * Dart_HandleMessage. The routine exits when all ports to the
- * current isolate are closed.
- *
- * \return A valid handle if the run loop exited successfully. If an
- * exception or other error occurs while processing messages, an
- * error handle is returned.
- */
-DART_EXPORT DART_WARN_UNUSED_RESULT Dart_Handle Dart_RunLoop(void);
-
-/**
- * Lets the VM run message processing for the isolate.
- *
- * This function expects there to a current isolate and the current isolate
- * must not have an active api scope. The VM will take care of making the
- * isolate runnable (if not already), handles its message loop and will take
- * care of shutting the isolate down once it's done.
- *
- * \param errors_are_fatal Whether uncaught errors should be fatal.
- * \param on_error_port A port to notify on uncaught errors (or ILLEGAL_PORT).
- * \param on_exit_port A port to notify on exit (or ILLEGAL_PORT).
- * \param error A non-NULL pointer which will hold an error message if the call
- * fails. The error has to be free()ed by the caller.
- *
- * \return If successful the VM takes owernship of the isolate and takes care
- * of its message loop. If not successful the caller retains owernship of the
- * isolate.
- */
-DART_EXPORT DART_WARN_UNUSED_RESULT bool Dart_RunLoopAsync(
- bool errors_are_fatal,
- Dart_Port on_error_port,
- Dart_Port on_exit_port,
- char** error);
-
-/* TODO(turnidge): Should this be removed from the public api? */
-
-/**
- * Gets the main port id for the current isolate.
- */
-DART_EXPORT Dart_Port Dart_GetMainPortId(void);
-
-/**
- * Does the current isolate have live ReceivePorts?
- *
- * A ReceivePort is live when it has not been closed.
- */
-DART_EXPORT bool Dart_HasLivePorts(void);
-
-/**
- * Posts a message for some isolate. The message is a serialized
- * object.
- *
- * Requires there to be a current isolate.
- *
- * For posting messages outside of an isolate see \ref Dart_PostCObject.
- *
- * \param port_id The destination port.
- * \param object An object from the current isolate.
- *
- * \return True if the message was posted.
- */
-DART_EXPORT bool Dart_Post(Dart_Port port_id, Dart_Handle object);
-
-/**
- * Returns a new SendPort with the provided port id.
- *
- * \param port_id The destination port.
- *
- * \return A new SendPort if no errors occurs. Otherwise returns
- * an error handle.
- */
-DART_EXPORT Dart_Handle Dart_NewSendPort(Dart_Port port_id);
-
-/**
- * Gets the SendPort id for the provided SendPort.
- * \param port A SendPort object whose id is desired.
- * \param port_id Returns the id of the SendPort.
- * \return Success if no error occurs. Otherwise returns
- * an error handle.
- */
-DART_EXPORT Dart_Handle Dart_SendPortGetId(Dart_Handle port,
- Dart_Port* port_id);
-
-/*
- * ======
- * Scopes
- * ======
- */
-
-/**
- * Enters a new scope.
- *
- * All new local handles will be created in this scope. Additionally,
- * some functions may return "scope allocated" memory which is only
- * valid within this scope.
- *
- * Requires there to be a current isolate.
- */
-DART_EXPORT void Dart_EnterScope(void);
-
-/**
- * Exits a scope.
- *
- * The previous scope (if any) becomes the current scope.
- *
- * Requires there to be a current isolate.
- */
-DART_EXPORT void Dart_ExitScope(void);
-
-/**
- * The Dart VM uses "zone allocation" for temporary structures. Zones
- * support very fast allocation of small chunks of memory. The chunks
- * cannot be deallocated individually, but instead zones support
- * deallocating all chunks in one fast operation.
- *
- * This function makes it possible for the embedder to allocate
- * temporary data in the VMs zone allocator.
- *
- * Zone allocation is possible:
- * 1. when inside a scope where local handles can be allocated
- * 2. when processing a message from a native port in a native port
- * handler
- *
- * All the memory allocated this way will be reclaimed either on the
- * next call to Dart_ExitScope or when the native port handler exits.
- *
- * \param size Size of the memory to allocate.
- *
- * \return A pointer to the allocated memory. NULL if allocation
- * failed. Failure might due to is no current VM zone.
- */
-DART_EXPORT uint8_t* Dart_ScopeAllocate(intptr_t size);
-
-/*
- * =======
- * Objects
- * =======
- */
-
-/**
- * Returns the null object.
- *
- * \return A handle to the null object.
- */
-DART_EXPORT Dart_Handle Dart_Null(void);
-
-/**
- * Is this object null?
- */
-DART_EXPORT bool Dart_IsNull(Dart_Handle object);
-
-/**
- * Returns the empty string object.
- *
- * \return A handle to the empty string object.
- */
-DART_EXPORT Dart_Handle Dart_EmptyString(void);
-
-/**
- * Returns types that are not classes, and which therefore cannot be looked up
- * as library members by Dart_GetType.
- *
- * \return A handle to the dynamic, void or Never type.
- */
-DART_EXPORT Dart_Handle Dart_TypeDynamic(void);
-DART_EXPORT Dart_Handle Dart_TypeVoid(void);
-DART_EXPORT Dart_Handle Dart_TypeNever(void);
-
-/**
- * Checks if the two objects are equal.
- *
- * The result of the comparison is returned through the 'equal'
- * parameter. The return value itself is used to indicate success or
- * failure, not equality.
- *
- * May generate an unhandled exception error.
- *
- * \param obj1 An object to be compared.
- * \param obj2 An object to be compared.
- * \param equal Returns the result of the equality comparison.
- *
- * \return A valid handle if no error occurs during the comparison.
- */
-DART_EXPORT Dart_Handle Dart_ObjectEquals(Dart_Handle obj1,
- Dart_Handle obj2,
- bool* equal);
-
-/**
- * Is this object an instance of some type?
- *
- * The result of the test is returned through the 'instanceof' parameter.
- * The return value itself is used to indicate success or failure.
- *
- * \param object An object.
- * \param type A type.
- * \param instanceof Return true if 'object' is an instance of type 'type'.
- *
- * \return A valid handle if no error occurs during the operation.
- */
-DART_EXPORT Dart_Handle Dart_ObjectIsType(Dart_Handle object,
- Dart_Handle type,
- bool* instanceof);
-
-/**
- * Query object type.
- *
- * \param object Some Object.
- *
- * \return true if Object is of the specified type.
- */
-DART_EXPORT bool Dart_IsInstance(Dart_Handle object);
-DART_EXPORT bool Dart_IsNumber(Dart_Handle object);
-DART_EXPORT bool Dart_IsInteger(Dart_Handle object);
-DART_EXPORT bool Dart_IsDouble(Dart_Handle object);
-DART_EXPORT bool Dart_IsBoolean(Dart_Handle object);
-DART_EXPORT bool Dart_IsString(Dart_Handle object);
-DART_EXPORT bool Dart_IsStringLatin1(Dart_Handle object); /* (ISO-8859-1) */
-DART_EXPORT bool Dart_IsExternalString(Dart_Handle object);
-DART_EXPORT bool Dart_IsList(Dart_Handle object);
-DART_EXPORT bool Dart_IsMap(Dart_Handle object);
-DART_EXPORT bool Dart_IsLibrary(Dart_Handle object);
-DART_EXPORT bool Dart_IsType(Dart_Handle handle);
-DART_EXPORT bool Dart_IsFunction(Dart_Handle handle);
-DART_EXPORT bool Dart_IsVariable(Dart_Handle handle);
-DART_EXPORT bool Dart_IsTypeVariable(Dart_Handle handle);
-DART_EXPORT bool Dart_IsClosure(Dart_Handle object);
-DART_EXPORT bool Dart_IsTypedData(Dart_Handle object);
-DART_EXPORT bool Dart_IsByteBuffer(Dart_Handle object);
-DART_EXPORT bool Dart_IsFuture(Dart_Handle object);
-
-/*
- * =========
- * Instances
- * =========
- */
-
-/*
- * For the purposes of the embedding api, not all objects returned are
- * Dart language objects. Within the api, we use the term 'Instance'
- * to indicate handles which refer to true Dart language objects.
- *
- * TODO(turnidge): Reorganize the "Object" section above, pulling down
- * any functions that more properly belong here. */
-
-/**
- * Gets the type of a Dart language object.
- *
- * \param instance Some Dart object.
- *
- * \return If no error occurs, the type is returned. Otherwise an
- * error handle is returned.
- */
-DART_EXPORT Dart_Handle Dart_InstanceGetType(Dart_Handle instance);
-
-/**
- * Returns the name for the provided class type.
- *
- * \return A valid string handle if no error occurs during the
- * operation.
- */
-DART_EXPORT Dart_Handle Dart_ClassName(Dart_Handle cls_type);
-
-/**
- * Returns the name for the provided function or method.
- *
- * \return A valid string handle if no error occurs during the
- * operation.
- */
-DART_EXPORT Dart_Handle Dart_FunctionName(Dart_Handle function);
-
-/**
- * Returns a handle to the owner of a function.
- *
- * The owner of an instance method or a static method is its defining
- * class. The owner of a top-level function is its defining
- * library. The owner of the function of a non-implicit closure is the
- * function of the method or closure that defines the non-implicit
- * closure.
- *
- * \return A valid handle to the owner of the function, or an error
- * handle if the argument is not a valid handle to a function.
- */
-DART_EXPORT Dart_Handle Dart_FunctionOwner(Dart_Handle function);
-
-/**
- * Determines whether a function handle referes to a static function
- * of method.
- *
- * For the purposes of the embedding API, a top-level function is
- * implicitly declared static.
- *
- * \param function A handle to a function or method declaration.
- * \param is_static Returns whether the function or method is declared static.
- *
- * \return A valid handle if no error occurs during the operation.
- */
-DART_EXPORT Dart_Handle Dart_FunctionIsStatic(Dart_Handle function,
- bool* is_static);
-
-/**
- * Is this object a closure resulting from a tear-off (closurized method)?
- *
- * Returns true for closures produced when an ordinary method is accessed
- * through a getter call. Returns false otherwise, in particular for closures
- * produced from local function declarations.
- *
- * \param object Some Object.
- *
- * \return true if Object is a tear-off.
- */
-DART_EXPORT bool Dart_IsTearOff(Dart_Handle object);
-
-/**
- * Retrieves the function of a closure.
- *
- * \return A handle to the function of the closure, or an error handle if the
- * argument is not a closure.
- */
-DART_EXPORT Dart_Handle Dart_ClosureFunction(Dart_Handle closure);
-
-/**
- * Returns a handle to the library which contains class.
- *
- * \return A valid handle to the library with owns class, null if the class
- * has no library or an error handle if the argument is not a valid handle
- * to a class type.
- */
-DART_EXPORT Dart_Handle Dart_ClassLibrary(Dart_Handle cls_type);
-
-/*
- * =============================
- * Numbers, Integers and Doubles
- * =============================
- */
-
-/**
- * Does this Integer fit into a 64-bit signed integer?
- *
- * \param integer An integer.
- * \param fits Returns true if the integer fits into a 64-bit signed integer.
- *
- * \return A valid handle if no error occurs during the operation.
- */
-DART_EXPORT Dart_Handle Dart_IntegerFitsIntoInt64(Dart_Handle integer,
- bool* fits);
-
-/**
- * Does this Integer fit into a 64-bit unsigned integer?
- *
- * \param integer An integer.
- * \param fits Returns true if the integer fits into a 64-bit unsigned integer.
- *
- * \return A valid handle if no error occurs during the operation.
- */
-DART_EXPORT Dart_Handle Dart_IntegerFitsIntoUint64(Dart_Handle integer,
- bool* fits);
-
-/**
- * Returns an Integer with the provided value.
- *
- * \param value The value of the integer.
- *
- * \return The Integer object if no error occurs. Otherwise returns
- * an error handle.
- */
-DART_EXPORT Dart_Handle Dart_NewInteger(int64_t value);
-
-/**
- * Returns an Integer with the provided value.
- *
- * \param value The unsigned value of the integer.
- *
- * \return The Integer object if no error occurs. Otherwise returns
- * an error handle.
- */
-DART_EXPORT Dart_Handle Dart_NewIntegerFromUint64(uint64_t value);
-
-/**
- * Returns an Integer with the provided value.
- *
- * \param value The value of the integer represented as a C string
- * containing a hexadecimal number.
- *
- * \return The Integer object if no error occurs. Otherwise returns
- * an error handle.
- */
-DART_EXPORT Dart_Handle Dart_NewIntegerFromHexCString(const char* value);
-
-/**
- * Gets the value of an Integer.
- *
- * The integer must fit into a 64-bit signed integer, otherwise an error occurs.
- *
- * \param integer An Integer.
- * \param value Returns the value of the Integer.
- *
- * \return A valid handle if no error occurs during the operation.
- */
-DART_EXPORT Dart_Handle Dart_IntegerToInt64(Dart_Handle integer,
- int64_t* value);
-
-/**
- * Gets the value of an Integer.
- *
- * The integer must fit into a 64-bit unsigned integer, otherwise an
- * error occurs.
- *
- * \param integer An Integer.
- * \param value Returns the value of the Integer.
- *
- * \return A valid handle if no error occurs during the operation.
- */
-DART_EXPORT Dart_Handle Dart_IntegerToUint64(Dart_Handle integer,
- uint64_t* value);
-
-/**
- * Gets the value of an integer as a hexadecimal C string.
- *
- * \param integer An Integer.
- * \param value Returns the value of the Integer as a hexadecimal C
- * string. This C string is scope allocated and is only valid until
- * the next call to Dart_ExitScope.
- *
- * \return A valid handle if no error occurs during the operation.
- */
-DART_EXPORT Dart_Handle Dart_IntegerToHexCString(Dart_Handle integer,
- const char** value);
-
-/**
- * Returns a Double with the provided value.
- *
- * \param value A double.
- *
- * \return The Double object if no error occurs. Otherwise returns
- * an error handle.
- */
-DART_EXPORT Dart_Handle Dart_NewDouble(double value);
-
-/**
- * Gets the value of a Double
- *
- * \param double_obj A Double
- * \param value Returns the value of the Double.
- *
- * \return A valid handle if no error occurs during the operation.
- */
-DART_EXPORT Dart_Handle Dart_DoubleValue(Dart_Handle double_obj, double* value);
-
-/**
- * Returns a closure of static function 'function_name' in the class 'class_name'
- * in the exported namespace of specified 'library'.
- *
- * \param library Library object
- * \param cls_type Type object representing a Class
- * \param function_name Name of the static function in the class
- *
- * \return A valid Dart instance if no error occurs during the operation.
- */
-DART_EXPORT Dart_Handle Dart_GetStaticMethodClosure(Dart_Handle library,
- Dart_Handle cls_type,
- Dart_Handle function_name);
-
-/*
- * ========
- * Booleans
- * ========
- */
-
-/**
- * Returns the True object.
- *
- * Requires there to be a current isolate.
- *
- * \return A handle to the True object.
- */
-DART_EXPORT Dart_Handle Dart_True(void);
-
-/**
- * Returns the False object.
- *
- * Requires there to be a current isolate.
- *
- * \return A handle to the False object.
- */
-DART_EXPORT Dart_Handle Dart_False(void);
-
-/**
- * Returns a Boolean with the provided value.
- *
- * \param value true or false.
- *
- * \return The Boolean object if no error occurs. Otherwise returns
- * an error handle.
- */
-DART_EXPORT Dart_Handle Dart_NewBoolean(bool value);
-
-/**
- * Gets the value of a Boolean
- *
- * \param boolean_obj A Boolean
- * \param value Returns the value of the Boolean.
- *
- * \return A valid handle if no error occurs during the operation.
- */
-DART_EXPORT Dart_Handle Dart_BooleanValue(Dart_Handle boolean_obj, bool* value);
-
-/*
- * =======
- * Strings
- * =======
- */
-
-/**
- * Gets the length of a String.
- *
- * \param str A String.
- * \param length Returns the length of the String.
- *
- * \return A valid handle if no error occurs during the operation.
- */
-DART_EXPORT Dart_Handle Dart_StringLength(Dart_Handle str, intptr_t* length);
-
-/**
- * Returns a String built from the provided C string
- * (There is an implicit assumption that the C string passed in contains
- * UTF-8 encoded characters and '\0' is considered as a termination
- * character).
- *
- * \param str A C String
- *
- * \return The String object if no error occurs. Otherwise returns
- * an error handle.
- */
-DART_EXPORT Dart_Handle Dart_NewStringFromCString(const char* str);
-/* TODO(turnidge): Document what happens when we run out of memory
- * during this call. */
-
-/**
- * Returns a String built from an array of UTF-8 encoded characters.
- *
- * \param utf8_array An array of UTF-8 encoded characters.
- * \param length The length of the codepoints array.
- *
- * \return The String object if no error occurs. Otherwise returns
- * an error handle.
- */
-DART_EXPORT Dart_Handle Dart_NewStringFromUTF8(const uint8_t* utf8_array,
- intptr_t length);
-
-/**
- * Returns a String built from an array of UTF-16 encoded characters.
- *
- * \param utf16_array An array of UTF-16 encoded characters.
- * \param length The length of the codepoints array.
- *
- * \return The String object if no error occurs. Otherwise returns
- * an error handle.
- */
-DART_EXPORT Dart_Handle Dart_NewStringFromUTF16(const uint16_t* utf16_array,
- intptr_t length);
-
-/**
- * Returns a String built from an array of UTF-32 encoded characters.
- *
- * \param utf32_array An array of UTF-32 encoded characters.
- * \param length The length of the codepoints array.
- *
- * \return The String object if no error occurs. Otherwise returns
- * an error handle.
- */
-DART_EXPORT Dart_Handle Dart_NewStringFromUTF32(const int32_t* utf32_array,
- intptr_t length);
-
-/**
- * Returns a String which references an external array of
- * Latin-1 (ISO-8859-1) encoded characters.
- *
- * \param latin1_array Array of Latin-1 encoded characters. This must not move.
- * \param length The length of the characters array.
- * \param peer An external pointer to associate with this string.
- * \param external_allocation_size The number of externally allocated
- * bytes for peer. Used to inform the garbage collector.
- * \param callback A callback to be called when this string is finalized.
- *
- * \return The String object if no error occurs. Otherwise returns
- * an error handle.
- */
-DART_EXPORT Dart_Handle
-Dart_NewExternalLatin1String(const uint8_t* latin1_array,
- intptr_t length,
- void* peer,
- intptr_t external_allocation_size,
- Dart_HandleFinalizer callback);
-
-/**
- * Returns a String which references an external array of UTF-16 encoded
- * characters.
- *
- * \param utf16_array An array of UTF-16 encoded characters. This must not move.
- * \param length The length of the characters array.
- * \param peer An external pointer to associate with this string.
- * \param external_allocation_size The number of externally allocated
- * bytes for peer. Used to inform the garbage collector.
- * \param callback A callback to be called when this string is finalized.
- *
- * \return The String object if no error occurs. Otherwise returns
- * an error handle.
- */
-DART_EXPORT Dart_Handle
-Dart_NewExternalUTF16String(const uint16_t* utf16_array,
- intptr_t length,
- void* peer,
- intptr_t external_allocation_size,
- Dart_HandleFinalizer callback);
-
-/**
- * Gets the C string representation of a String.
- * (It is a sequence of UTF-8 encoded values with a '\0' termination.)
- *
- * \param str A string.
- * \param cstr Returns the String represented as a C string.
- * This C string is scope allocated and is only valid until
- * the next call to Dart_ExitScope.
- *
- * \return A valid handle if no error occurs during the operation.
- */
-DART_EXPORT Dart_Handle Dart_StringToCString(Dart_Handle str,
- const char** cstr);
-
-/**
- * Gets a UTF-8 encoded representation of a String.
- *
- * Any unpaired surrogate code points in the string will be converted as
- * replacement characters (U+FFFD, 0xEF 0xBF 0xBD in UTF-8). If you need
- * to preserve unpaired surrogates, use the Dart_StringToUTF16 function.
- *
- * \param str A string.
- * \param utf8_array Returns the String represented as UTF-8 code
- * units. This UTF-8 array is scope allocated and is only valid
- * until the next call to Dart_ExitScope.
- * \param length Used to return the length of the array which was
- * actually used.
- *
- * \return A valid handle if no error occurs during the operation.
- */
-DART_EXPORT Dart_Handle Dart_StringToUTF8(Dart_Handle str,
- uint8_t** utf8_array,
- intptr_t* length);
-
-/**
- * Gets the data corresponding to the string object. This function returns
- * the data only for Latin-1 (ISO-8859-1) string objects. For all other
- * string objects it returns an error.
- *
- * \param str A string.
- * \param latin1_array An array allocated by the caller, used to return
- * the string data.
- * \param length Used to pass in the length of the provided array.
- * Used to return the length of the array which was actually used.
- *
- * \return A valid handle if no error occurs during the operation.
- */
-DART_EXPORT Dart_Handle Dart_StringToLatin1(Dart_Handle str,
- uint8_t* latin1_array,
- intptr_t* length);
-
-/**
- * Gets the UTF-16 encoded representation of a string.
- *
- * \param str A string.
- * \param utf16_array An array allocated by the caller, used to return
- * the array of UTF-16 encoded characters.
- * \param length Used to pass in the length of the provided array.
- * Used to return the length of the array which was actually used.
- *
- * \return A valid handle if no error occurs during the operation.
- */
-DART_EXPORT Dart_Handle Dart_StringToUTF16(Dart_Handle str,
- uint16_t* utf16_array,
- intptr_t* length);
-
-/**
- * Gets the storage size in bytes of a String.
- *
- * \param str A String.
- * \param size Returns the storage size in bytes of the String.
- * This is the size in bytes needed to store the String.
- *
- * \return A valid handle if no error occurs during the operation.
- */
-DART_EXPORT Dart_Handle Dart_StringStorageSize(Dart_Handle str, intptr_t* size);
-
-/**
- * Retrieves some properties associated with a String.
- * Properties retrieved are:
- * - character size of the string (one or two byte)
- * - length of the string
- * - peer pointer of string if it is an external string.
- * \param str A String.
- * \param char_size Returns the character size of the String.
- * \param str_len Returns the length of the String.
- * \param peer Returns the peer pointer associated with the String or 0 if
- * there is no peer pointer for it.
- * \return Success if no error occurs. Otherwise returns
- * an error handle.
- */
-DART_EXPORT Dart_Handle Dart_StringGetProperties(Dart_Handle str,
- intptr_t* char_size,
- intptr_t* str_len,
- void** peer);
-
-/*
- * =====
- * Lists
- * =====
- */
-
-/**
- * Returns a List<dynamic> of the desired length.
- *
- * \param length The length of the list.
- *
- * \return The List object if no error occurs. Otherwise returns
- * an error handle.
- */
-DART_EXPORT Dart_Handle Dart_NewList(intptr_t length);
-
-typedef enum {
- Dart_CoreType_Dynamic,
- Dart_CoreType_Int,
- Dart_CoreType_String,
-} Dart_CoreType_Id;
-
-// TODO(bkonyi): convert this to use nullable types once NNBD is enabled.
-/**
- * Returns a List of the desired length with the desired legacy element type.
- *
- * \param element_type_id The type of elements of the list.
- * \param length The length of the list.
- *
- * \return The List object if no error occurs. Otherwise returns an error
- * handle.
- */
-DART_EXPORT Dart_Handle Dart_NewListOf(Dart_CoreType_Id element_type_id,
- intptr_t length);
-
-/**
- * Returns a List of the desired length with the desired element type.
- *
- * \param element_type Handle to a nullable type object. E.g., from
- * Dart_GetType or Dart_GetNullableType.
- *
- * \param length The length of the list.
- *
- * \return The List object if no error occurs. Otherwise returns
- * an error handle.
- */
-DART_EXPORT Dart_Handle Dart_NewListOfType(Dart_Handle element_type,
- intptr_t length);
-
-/**
- * Returns a List of the desired length with the desired element type, filled
- * with the provided object.
- *
- * \param element_type Handle to a type object. E.g., from Dart_GetType.
- *
- * \param fill_object Handle to an object of type 'element_type' that will be
- * used to populate the list. This parameter can only be Dart_Null() if the
- * length of the list is 0 or 'element_type' is a nullable type.
- *
- * \param length The length of the list.
- *
- * \return The List object if no error occurs. Otherwise returns
- * an error handle.
- */
-DART_EXPORT Dart_Handle Dart_NewListOfTypeFilled(Dart_Handle element_type,
- Dart_Handle fill_object,
- intptr_t length);
-
-/**
- * Gets the length of a List.
- *
- * May generate an unhandled exception error.
- *
- * \param list A List.
- * \param length Returns the length of the List.
- *
- * \return A valid handle if no error occurs during the operation.
- */
-DART_EXPORT Dart_Handle Dart_ListLength(Dart_Handle list, intptr_t* length);
-
-/**
- * Gets the Object at some index of a List.
- *
- * If the index is out of bounds, an error occurs.
- *
- * May generate an unhandled exception error.
- *
- * \param list A List.
- * \param index A valid index into the List.
- *
- * \return The Object in the List at the specified index if no error
- * occurs. Otherwise returns an error handle.
- */
-DART_EXPORT Dart_Handle Dart_ListGetAt(Dart_Handle list, intptr_t index);
-
-/**
-* Gets a range of Objects from a List.
-*
-* If any of the requested index values are out of bounds, an error occurs.
-*
-* May generate an unhandled exception error.
-*
-* \param list A List.
-* \param offset The offset of the first item to get.
-* \param length The number of items to get.
-* \param result A pointer to fill with the objects.
-*
-* \return Success if no error occurs during the operation.
-*/
-DART_EXPORT Dart_Handle Dart_ListGetRange(Dart_Handle list,
- intptr_t offset,
- intptr_t length,
- Dart_Handle* result);
-
-/**
- * Sets the Object at some index of a List.
- *
- * If the index is out of bounds, an error occurs.
- *
- * May generate an unhandled exception error.
- *
- * \param list A List.
- * \param index A valid index into the List.
- * \param value The Object to put in the List.
- *
- * \return A valid handle if no error occurs during the operation.
- */
-DART_EXPORT Dart_Handle Dart_ListSetAt(Dart_Handle list,
- intptr_t index,
- Dart_Handle value);
-
-/**
- * May generate an unhandled exception error.
- */
-DART_EXPORT Dart_Handle Dart_ListGetAsBytes(Dart_Handle list,
- intptr_t offset,
- uint8_t* native_array,
- intptr_t length);
-
-/**
- * May generate an unhandled exception error.
- */
-DART_EXPORT Dart_Handle Dart_ListSetAsBytes(Dart_Handle list,
- intptr_t offset,
- const uint8_t* native_array,
- intptr_t length);
-
-/*
- * ====
- * Maps
- * ====
- */
-
-/**
- * Gets the Object at some key of a Map.
- *
- * May generate an unhandled exception error.
- *
- * \param map A Map.
- * \param key An Object.
- *
- * \return The value in the map at the specified key, null if the map does not
- * contain the key, or an error handle.
- */
-DART_EXPORT Dart_Handle Dart_MapGetAt(Dart_Handle map, Dart_Handle key);
-
-/**
- * Returns whether the Map contains a given key.
- *
- * May generate an unhandled exception error.
- *
- * \param map A Map.
- *
- * \return A handle on a boolean indicating whether map contains the key.
- * Otherwise returns an error handle.
- */
-DART_EXPORT Dart_Handle Dart_MapContainsKey(Dart_Handle map, Dart_Handle key);
-
-/**
- * Gets the list of keys of a Map.
- *
- * May generate an unhandled exception error.
- *
- * \param map A Map.
- *
- * \return The list of key Objects if no error occurs. Otherwise returns an
- * error handle.
- */
-DART_EXPORT Dart_Handle Dart_MapKeys(Dart_Handle map);
-
-/*
- * ==========
- * Typed Data
- * ==========
- */
-
-typedef enum {
- Dart_TypedData_kByteData = 0,
- Dart_TypedData_kInt8,
- Dart_TypedData_kUint8,
- Dart_TypedData_kUint8Clamped,
- Dart_TypedData_kInt16,
- Dart_TypedData_kUint16,
- Dart_TypedData_kInt32,
- Dart_TypedData_kUint32,
- Dart_TypedData_kInt64,
- Dart_TypedData_kUint64,
- Dart_TypedData_kFloat32,
- Dart_TypedData_kFloat64,
- Dart_TypedData_kInt32x4,
- Dart_TypedData_kFloat32x4,
- Dart_TypedData_kFloat64x2,
- Dart_TypedData_kInvalid
-} Dart_TypedData_Type;
-
-/**
- * Return type if this object is a TypedData object.
- *
- * \return kInvalid if the object is not a TypedData object or the appropriate
- * Dart_TypedData_Type.
- */
-DART_EXPORT Dart_TypedData_Type Dart_GetTypeOfTypedData(Dart_Handle object);
-
-/**
- * Return type if this object is an external TypedData object.
- *
- * \return kInvalid if the object is not an external TypedData object or
- * the appropriate Dart_TypedData_Type.
- */
-DART_EXPORT Dart_TypedData_Type
-Dart_GetTypeOfExternalTypedData(Dart_Handle object);
-
-/**
- * Returns a TypedData object of the desired length and type.
- *
- * \param type The type of the TypedData object.
- * \param length The length of the TypedData object (length in type units).
- *
- * \return The TypedData object if no error occurs. Otherwise returns
- * an error handle.
- */
-DART_EXPORT Dart_Handle Dart_NewTypedData(Dart_TypedData_Type type,
- intptr_t length);
-
-/**
- * Returns a TypedData object which references an external data array.
- *
- * \param type The type of the data array.
- * \param data A data array. This array must not move.
- * \param length The length of the data array (length in type units).
- *
- * \return The TypedData object if no error occurs. Otherwise returns
- * an error handle.
- */
-DART_EXPORT Dart_Handle Dart_NewExternalTypedData(Dart_TypedData_Type type,
- void* data,
- intptr_t length);
-
-/**
- * Returns a TypedData object which references an external data array.
- *
- * \param type The type of the data array.
- * \param data A data array. This array must not move.
- * \param length The length of the data array (length in type units).
- * \param peer A pointer to a native object or NULL. This value is
- * provided to callback when it is invoked.
- * \param external_allocation_size The number of externally allocated
- * bytes for peer. Used to inform the garbage collector.
- * \param callback A function pointer that will be invoked sometime
- * after the object is garbage collected, unless the handle has been deleted.
- * A valid callback needs to be specified it cannot be NULL.
- *
- * \return The TypedData object if no error occurs. Otherwise returns
- * an error handle.
- */
-DART_EXPORT Dart_Handle
-Dart_NewExternalTypedDataWithFinalizer(Dart_TypedData_Type type,
- void* data,
- intptr_t length,
- void* peer,
- intptr_t external_allocation_size,
- Dart_HandleFinalizer callback);
-DART_EXPORT Dart_Handle Dart_NewUnmodifiableExternalTypedDataWithFinalizer(
- Dart_TypedData_Type type,
- const void* data,
- intptr_t length,
- void* peer,
- intptr_t external_allocation_size,
- Dart_HandleFinalizer callback);
-
-/**
- * Returns a ByteBuffer object for the typed data.
- *
- * \param typed_data The TypedData object.
- *
- * \return The ByteBuffer object if no error occurs. Otherwise returns
- * an error handle.
- */
-DART_EXPORT Dart_Handle Dart_NewByteBuffer(Dart_Handle typed_data);
-
-/**
- * Acquires access to the internal data address of a TypedData object.
- *
- * \param object The typed data object whose internal data address is to
- * be accessed.
- * \param type The type of the object is returned here.
- * \param data The internal data address is returned here.
- * \param len Size of the typed array is returned here.
- *
- * Notes:
- * When the internal address of the object is acquired any calls to a
- * Dart API function that could potentially allocate an object or run
- * any Dart code will return an error.
- *
- * Any Dart API functions for accessing the data should not be called
- * before the corresponding release. In particular, the object should
- * not be acquired again before its release. This leads to undefined
- * behavior.
- *
- * \return Success if the internal data address is acquired successfully.
- * Otherwise, returns an error handle.
- */
-DART_EXPORT Dart_Handle Dart_TypedDataAcquireData(Dart_Handle object,
- Dart_TypedData_Type* type,
- void** data,
- intptr_t* len);
-
-/**
- * Releases access to the internal data address that was acquired earlier using
- * Dart_TypedDataAcquireData.
- *
- * \param object The typed data object whose internal data address is to be
- * released.
- *
- * \return Success if the internal data address is released successfully.
- * Otherwise, returns an error handle.
- */
-DART_EXPORT Dart_Handle Dart_TypedDataReleaseData(Dart_Handle object);
-
-/**
- * Returns the TypedData object associated with the ByteBuffer object.
- *
- * \param byte_buffer The ByteBuffer object.
- *
- * \return The TypedData object if no error occurs. Otherwise returns
- * an error handle.
- */
-DART_EXPORT Dart_Handle Dart_GetDataFromByteBuffer(Dart_Handle byte_buffer);
-
-/*
- * ============================================================
- * Invoking Constructors, Methods, Closures and Field accessors
- * ============================================================
- */
-
-/**
- * Invokes a constructor, creating a new object.
- *
- * This function allows hidden constructors (constructors with leading
- * underscores) to be called.
- *
- * \param type Type of object to be constructed.
- * \param constructor_name The name of the constructor to invoke. Use
- * Dart_Null() or Dart_EmptyString() to invoke the unnamed constructor.
- * This name should not include the name of the class.
- * \param number_of_arguments Size of the arguments array.
- * \param arguments An array of arguments to the constructor.
- *
- * \return If the constructor is called and completes successfully,
- * then the new object. If an error occurs during execution, then an
- * error handle is returned.
- */
-DART_EXPORT DART_WARN_UNUSED_RESULT Dart_Handle
-Dart_New(Dart_Handle type,
- Dart_Handle constructor_name,
- int number_of_arguments,
- Dart_Handle* arguments);
-
-/**
- * Allocate a new object without invoking a constructor.
- *
- * \param type The type of an object to be allocated.
- *
- * \return The new object. If an error occurs during execution, then an
- * error handle is returned.
- */
-DART_EXPORT DART_WARN_UNUSED_RESULT Dart_Handle Dart_Allocate(Dart_Handle type);
-
-/**
- * Allocate a new object without invoking a constructor, and sets specified
- * native fields.
- *
- * \param type The type of an object to be allocated.
- * \param num_native_fields The number of native fields to set.
- * \param native_fields An array containing the value of native fields.
- *
- * \return The new object. If an error occurs during execution, then an
- * error handle is returned.
- */
-DART_EXPORT Dart_Handle
-Dart_AllocateWithNativeFields(Dart_Handle type,
- intptr_t num_native_fields,
- const intptr_t* native_fields);
-
-/**
- * Invokes a method or function.
- *
- * The 'target' parameter may be an object, type, or library. If
- * 'target' is an object, then this function will invoke an instance
- * method. If 'target' is a type, then this function will invoke a
- * static method. If 'target' is a library, then this function will
- * invoke a top-level function from that library.
- * NOTE: This API call cannot be used to invoke methods of a type object.
- *
- * This function ignores visibility (leading underscores in names).
- *
- * May generate an unhandled exception error.
- *
- * \param target An object, type, or library.
- * \param name The name of the function or method to invoke.
- * \param number_of_arguments Size of the arguments array.
- * \param arguments An array of arguments to the function.
- *
- * \return If the function or method is called and completes
- * successfully, then the return value is returned. If an error
- * occurs during execution, then an error handle is returned.
- */
-DART_EXPORT DART_WARN_UNUSED_RESULT Dart_Handle
-Dart_Invoke(Dart_Handle target,
- Dart_Handle name,
- int number_of_arguments,
- Dart_Handle* arguments);
-/* TODO(turnidge): Document how to invoke operators. */
-
-/**
- * Invokes a Closure with the given arguments.
- *
- * May generate an unhandled exception error.
- *
- * \return If no error occurs during execution, then the result of
- * invoking the closure is returned. If an error occurs during
- * execution, then an error handle is returned.
- */
-DART_EXPORT DART_WARN_UNUSED_RESULT Dart_Handle
-Dart_InvokeClosure(Dart_Handle closure,
- int number_of_arguments,
- Dart_Handle* arguments);
-
-/**
- * Invokes a Generative Constructor on an object that was previously
- * allocated using Dart_Allocate/Dart_AllocateWithNativeFields.
- *
- * The 'object' parameter must be an object.
- *
- * This function ignores visibility (leading underscores in names).
- *
- * May generate an unhandled exception error.
- *
- * \param object An object.
- * \param name The name of the constructor to invoke.
- * Use Dart_Null() or Dart_EmptyString() to invoke the unnamed constructor.
- * \param number_of_arguments Size of the arguments array.
- * \param arguments An array of arguments to the function.
- *
- * \return If the constructor is called and completes
- * successfully, then the object is returned. If an error
- * occurs during execution, then an error handle is returned.
- */
-DART_EXPORT DART_WARN_UNUSED_RESULT Dart_Handle
-Dart_InvokeConstructor(Dart_Handle object,
- Dart_Handle name,
- int number_of_arguments,
- Dart_Handle* arguments);
-
-/**
- * Gets the value of a field.
- *
- * The 'container' parameter may be an object, type, or library. If
- * 'container' is an object, then this function will access an
- * instance field. If 'container' is a type, then this function will
- * access a static field. If 'container' is a library, then this
- * function will access a top-level variable.
- * NOTE: This API call cannot be used to access fields of a type object.
- *
- * This function ignores field visibility (leading underscores in names).
- *
- * May generate an unhandled exception error.
- *
- * \param container An object, type, or library.
- * \param name A field name.
- *
- * \return If no error occurs, then the value of the field is
- * returned. Otherwise an error handle is returned.
- */
-DART_EXPORT DART_WARN_UNUSED_RESULT Dart_Handle
-Dart_GetField(Dart_Handle container, Dart_Handle name);
-
-/**
- * Sets the value of a field.
- *
- * The 'container' parameter may actually be an object, type, or
- * library. If 'container' is an object, then this function will
- * access an instance field. If 'container' is a type, then this
- * function will access a static field. If 'container' is a library,
- * then this function will access a top-level variable.
- * NOTE: This API call cannot be used to access fields of a type object.
- *
- * This function ignores field visibility (leading underscores in names).
- *
- * May generate an unhandled exception error.
- *
- * \param container An object, type, or library.
- * \param name A field name.
- * \param value The new field value.
- *
- * \return A valid handle if no error occurs.
- */
-DART_EXPORT DART_WARN_UNUSED_RESULT Dart_Handle
-Dart_SetField(Dart_Handle container, Dart_Handle name, Dart_Handle value);
-
-/*
- * ==========
- * Exceptions
- * ==========
- */
-
-/*
- * TODO(turnidge): Remove these functions from the api and replace all
- * uses with Dart_NewUnhandledExceptionError. */
-
-/**
- * Throws an exception.
- *
- * This function causes a Dart language exception to be thrown. This
- * will proceed in the standard way, walking up Dart frames until an
- * appropriate 'catch' block is found, executing 'finally' blocks,
- * etc.
- *
- * If an error handle is passed into this function, the error is
- * propagated immediately. See Dart_PropagateError for a discussion
- * of error propagation.
- *
- * If successful, this function does not return. Note that this means
- * that the destructors of any stack-allocated C++ objects will not be
- * called. If there are no Dart frames on the stack, an error occurs.
- *
- * \return An error handle if the exception was not thrown.
- * Otherwise the function does not return.
- */
-DART_EXPORT Dart_Handle Dart_ThrowException(Dart_Handle exception);
-
-/**
- * Rethrows an exception.
- *
- * Rethrows an exception, unwinding all dart frames on the stack. If
- * successful, this function does not return. Note that this means
- * that the destructors of any stack-allocated C++ objects will not be
- * called. If there are no Dart frames on the stack, an error occurs.
- *
- * \return An error handle if the exception was not thrown.
- * Otherwise the function does not return.
- */
-DART_EXPORT Dart_Handle Dart_ReThrowException(Dart_Handle exception,
- Dart_Handle stacktrace);
-
-/*
- * ===========================
- * Native fields and functions
- * ===========================
- */
-
-/**
- * Gets the number of native instance fields in an object.
- */
-DART_EXPORT Dart_Handle Dart_GetNativeInstanceFieldCount(Dart_Handle obj,
- int* count);
-
-/**
- * Gets the value of a native field.
- *
- * TODO(turnidge): Document.
- */
-DART_EXPORT Dart_Handle Dart_GetNativeInstanceField(Dart_Handle obj,
- int index,
- intptr_t* value);
-
-/**
- * Sets the value of a native field.
- *
- * TODO(turnidge): Document.
- */
-DART_EXPORT Dart_Handle Dart_SetNativeInstanceField(Dart_Handle obj,
- int index,
- intptr_t value);
-
-/**
- * The arguments to a native function.
- *
- * This object is passed to a native function to represent its
- * arguments and return value. It allows access to the arguments to a
- * native function by index. It also allows the return value of a
- * native function to be set.
- */
-typedef struct _Dart_NativeArguments* Dart_NativeArguments;
-
-/**
- * Extracts current isolate group data from the native arguments structure.
- */
-DART_EXPORT void* Dart_GetNativeIsolateGroupData(Dart_NativeArguments args);
-
-typedef enum {
- Dart_NativeArgument_kBool = 0,
- Dart_NativeArgument_kInt32,
- Dart_NativeArgument_kUint32,
- Dart_NativeArgument_kInt64,
- Dart_NativeArgument_kUint64,
- Dart_NativeArgument_kDouble,
- Dart_NativeArgument_kString,
- Dart_NativeArgument_kInstance,
- Dart_NativeArgument_kNativeFields,
-} Dart_NativeArgument_Type;
-
-typedef struct _Dart_NativeArgument_Descriptor {
- uint8_t type;
- uint8_t index;
-} Dart_NativeArgument_Descriptor;
-
-typedef union _Dart_NativeArgument_Value {
- bool as_bool;
- int32_t as_int32;
- uint32_t as_uint32;
- int64_t as_int64;
- uint64_t as_uint64;
- double as_double;
- struct {
- Dart_Handle dart_str;
- void* peer;
- } as_string;
- struct {
- intptr_t num_fields;
- intptr_t* values;
- } as_native_fields;
- Dart_Handle as_instance;
-} Dart_NativeArgument_Value;
-
-enum {
- kNativeArgNumberPos = 0,
- kNativeArgNumberSize = 8,
- kNativeArgTypePos = kNativeArgNumberPos + kNativeArgNumberSize,
- kNativeArgTypeSize = 8,
-};
-
-#define BITMASK(size) ((1 << size) - 1)
-#define DART_NATIVE_ARG_DESCRIPTOR(type, position) \
- (((type & BITMASK(kNativeArgTypeSize)) << kNativeArgTypePos) | \
- (position & BITMASK(kNativeArgNumberSize)))
-
-/**
- * Gets the native arguments based on the types passed in and populates
- * the passed arguments buffer with appropriate native values.
- *
- * \param args the Native arguments block passed into the native call.
- * \param num_arguments length of argument descriptor array and argument
- * values array passed in.
- * \param arg_descriptors an array that describes the arguments that
- * need to be retrieved. For each argument to be retrieved the descriptor
- * contains the argument number (0, 1 etc.) and the argument type
- * described using Dart_NativeArgument_Type, e.g:
- * DART_NATIVE_ARG_DESCRIPTOR(Dart_NativeArgument_kBool, 1) indicates
- * that the first argument is to be retrieved and it should be a boolean.
- * \param arg_values array into which the native arguments need to be
- * extracted into, the array is allocated by the caller (it could be
- * stack allocated to avoid the malloc/free performance overhead).
- *
- * \return Success if all the arguments could be extracted correctly,
- * returns an error handle if there were any errors while extracting the
- * arguments (mismatched number of arguments, incorrect types, etc.).
- */
-DART_EXPORT Dart_Handle
-Dart_GetNativeArguments(Dart_NativeArguments args,
- int num_arguments,
- const Dart_NativeArgument_Descriptor* arg_descriptors,
- Dart_NativeArgument_Value* arg_values);
-
-/**
- * Gets the native argument at some index.
- */
-DART_EXPORT Dart_Handle Dart_GetNativeArgument(Dart_NativeArguments args,
- int index);
-/* TODO(turnidge): Specify the behavior of an out-of-bounds access. */
-
-/**
- * Gets the number of native arguments.
- */
-DART_EXPORT int Dart_GetNativeArgumentCount(Dart_NativeArguments args);
-
-/**
- * Gets all the native fields of the native argument at some index.
- * \param args Native arguments structure.
- * \param arg_index Index of the desired argument in the structure above.
- * \param num_fields size of the intptr_t array 'field_values' passed in.
- * \param field_values intptr_t array in which native field values are returned.
- * \return Success if the native fields where copied in successfully. Otherwise
- * returns an error handle. On success the native field values are copied
- * into the 'field_values' array, if the argument at 'arg_index' is a
- * null object then 0 is copied as the native field values into the
- * 'field_values' array.
- */
-DART_EXPORT Dart_Handle
-Dart_GetNativeFieldsOfArgument(Dart_NativeArguments args,
- int arg_index,
- int num_fields,
- intptr_t* field_values);
-
-/**
- * Gets the native field of the receiver.
- */
-DART_EXPORT Dart_Handle Dart_GetNativeReceiver(Dart_NativeArguments args,
- intptr_t* value);
-
-/**
- * Gets a string native argument at some index.
- * \param args Native arguments structure.
- * \param arg_index Index of the desired argument in the structure above.
- * \param peer Returns the peer pointer if the string argument has one.
- * \return Success if the string argument has a peer, if it does not
- * have a peer then the String object is returned. Otherwise returns
- * an error handle (argument is not a String object).
- */
-DART_EXPORT Dart_Handle Dart_GetNativeStringArgument(Dart_NativeArguments args,
- int arg_index,
- void** peer);
-
-/**
- * Gets an integer native argument at some index.
- * \param args Native arguments structure.
- * \param index Index of the desired argument in the structure above.
- * \param value Returns the integer value if the argument is an Integer.
- * \return Success if no error occurs. Otherwise returns an error handle.
- */
-DART_EXPORT Dart_Handle Dart_GetNativeIntegerArgument(Dart_NativeArguments args,
- int index,
- int64_t* value);
-
-/**
- * Gets a boolean native argument at some index.
- * \param args Native arguments structure.
- * \param index Index of the desired argument in the structure above.
- * \param value Returns the boolean value if the argument is a Boolean.
- * \return Success if no error occurs. Otherwise returns an error handle.
- */
-DART_EXPORT Dart_Handle Dart_GetNativeBooleanArgument(Dart_NativeArguments args,
- int index,
- bool* value);
-
-/**
- * Gets a double native argument at some index.
- * \param args Native arguments structure.
- * \param index Index of the desired argument in the structure above.
- * \param value Returns the double value if the argument is a double.
- * \return Success if no error occurs. Otherwise returns an error handle.
- */
-DART_EXPORT Dart_Handle Dart_GetNativeDoubleArgument(Dart_NativeArguments args,
- int index,
- double* value);
-
-/**
- * Sets the return value for a native function.
- *
- * If retval is an Error handle, then error will be propagated once
- * the native functions exits. See Dart_PropagateError for a
- * discussion of how different types of errors are propagated.
- */
-DART_EXPORT void Dart_SetReturnValue(Dart_NativeArguments args,
- Dart_Handle retval);
-
-DART_EXPORT void Dart_SetWeakHandleReturnValue(Dart_NativeArguments args,
- Dart_WeakPersistentHandle rval);
-
-DART_EXPORT void Dart_SetBooleanReturnValue(Dart_NativeArguments args,
- bool retval);
-
-DART_EXPORT void Dart_SetIntegerReturnValue(Dart_NativeArguments args,
- int64_t retval);
-
-DART_EXPORT void Dart_SetDoubleReturnValue(Dart_NativeArguments args,
- double retval);
-
-/**
- * A native function.
- */
-typedef void (*Dart_NativeFunction)(Dart_NativeArguments arguments);
-
-/**
- * Native entry resolution callback.
- *
- * For libraries and scripts which have native functions, the embedder
- * can provide a native entry resolver. This callback is used to map a
- * name/arity to a Dart_NativeFunction. If no function is found, the
- * callback should return NULL.
- *
- * The parameters to the native resolver function are:
- * \param name a Dart string which is the name of the native function.
- * \param num_of_arguments is the number of arguments expected by the
- * native function.
- * \param auto_setup_scope is a boolean flag that can be set by the resolver
- * to indicate if this function needs a Dart API scope (see Dart_EnterScope/
- * Dart_ExitScope) to be setup automatically by the VM before calling into
- * the native function. By default most native functions would require this
- * to be true but some light weight native functions which do not call back
- * into the VM through the Dart API may not require a Dart scope to be
- * setup automatically.
- *
- * \return A valid Dart_NativeFunction which resolves to a native entry point
- * for the native function.
- *
- * See Dart_SetNativeResolver.
- */
-typedef Dart_NativeFunction (*Dart_NativeEntryResolver)(Dart_Handle name,
- int num_of_arguments,
- bool* auto_setup_scope);
-/* TODO(turnidge): Consider renaming to NativeFunctionResolver or
- * NativeResolver. */
-
-/**
- * Native entry symbol lookup callback.
- *
- * For libraries and scripts which have native functions, the embedder
- * can provide a callback for mapping a native entry to a symbol. This callback
- * maps a native function entry PC to the native function name. If no native
- * entry symbol can be found, the callback should return NULL.
- *
- * The parameters to the native reverse resolver function are:
- * \param nf A Dart_NativeFunction.
- *
- * \return A const UTF-8 string containing the symbol name or NULL.
- *
- * See Dart_SetNativeResolver.
- */
-typedef const uint8_t* (*Dart_NativeEntrySymbol)(Dart_NativeFunction nf);
-
-/**
- * FFI Native C function pointer resolver callback.
- *
- * See Dart_SetFfiNativeResolver.
- */
-typedef void* (*Dart_FfiNativeResolver)(const char* name, uintptr_t args_n);
-
-/*
- * ===========
- * Environment
- * ===========
- */
-
-/**
- * An environment lookup callback function.
- *
- * \param name The name of the value to lookup in the environment.
- *
- * \return A valid handle to a string if the name exists in the
- * current environment or Dart_Null() if not.
- */
-typedef Dart_Handle (*Dart_EnvironmentCallback)(Dart_Handle name);
-
-/**
- * Sets the environment callback for the current isolate. This
- * callback is used to lookup environment values by name in the
- * current environment. This enables the embedder to supply values for
- * the const constructors bool.fromEnvironment, int.fromEnvironment
- * and String.fromEnvironment.
- */
-DART_EXPORT Dart_Handle
-Dart_SetEnvironmentCallback(Dart_EnvironmentCallback callback);
-
-/**
- * Sets the callback used to resolve native functions for a library.
- *
- * \param library A library.
- * \param resolver A native entry resolver.
- *
- * \return A valid handle if the native resolver was set successfully.
- */
-DART_EXPORT Dart_Handle
-Dart_SetNativeResolver(Dart_Handle library,
- Dart_NativeEntryResolver resolver,
- Dart_NativeEntrySymbol symbol);
-/* TODO(turnidge): Rename to Dart_LibrarySetNativeResolver? */
-
-/**
- * Returns the callback used to resolve native functions for a library.
- *
- * \param library A library.
- * \param resolver a pointer to a Dart_NativeEntryResolver
- *
- * \return A valid handle if the library was found.
- */
-DART_EXPORT Dart_Handle
-Dart_GetNativeResolver(Dart_Handle library, Dart_NativeEntryResolver* resolver);
-
-/**
- * Returns the callback used to resolve native function symbols for a library.
- *
- * \param library A library.
- * \param resolver a pointer to a Dart_NativeEntrySymbol.
- *
- * \return A valid handle if the library was found.
- */
-DART_EXPORT Dart_Handle Dart_GetNativeSymbol(Dart_Handle library,
- Dart_NativeEntrySymbol* resolver);
-
-/**
- * Sets the callback used to resolve FFI native functions for a library.
- * The resolved functions are expected to be a C function pointer of the
- * correct signature (as specified in the `@FfiNative<NFT>()` function
- * annotation in Dart code).
- *
- * NOTE: This is an experimental feature and might change in the future.
- *
- * \param library A library.
- * \param resolver A native function resolver.
- *
- * \return A valid handle if the native resolver was set successfully.
- */
-DART_EXPORT Dart_Handle
-Dart_SetFfiNativeResolver(Dart_Handle library, Dart_FfiNativeResolver resolver);
-
-/*
- * =====================
- * Scripts and Libraries
- * =====================
- */
-
-typedef enum {
- Dart_kCanonicalizeUrl = 0,
- Dart_kImportTag,
- Dart_kKernelTag,
-} Dart_LibraryTag;
-
-/**
- * The library tag handler is a multi-purpose callback provided by the
- * embedder to the Dart VM. The embedder implements the tag handler to
- * provide the ability to load Dart scripts and imports.
- *
- * -- TAGS --
- *
- * Dart_kCanonicalizeUrl
- *
- * This tag indicates that the embedder should canonicalize 'url' with
- * respect to 'library'. For most embedders, the
- * Dart_DefaultCanonicalizeUrl function is a sufficient implementation
- * of this tag. The return value should be a string holding the
- * canonicalized url.
- *
- * Dart_kImportTag
- *
- * This tag is used to load a library from IsolateMirror.loadUri. The embedder
- * should call Dart_LoadLibraryFromKernel to provide the library to the VM. The
- * return value should be an error or library (the result from
- * Dart_LoadLibraryFromKernel).
- *
- * Dart_kKernelTag
- *
- * This tag is used to load the intermediate file (kernel) generated by
- * the Dart front end. This tag is typically used when a 'hot-reload'
- * of an application is needed and the VM is 'use dart front end' mode.
- * The dart front end typically compiles all the scripts, imports and part
- * files into one intermediate file hence we don't use the source/import or
- * script tags. The return value should be an error or a TypedData containing
- * the kernel bytes.
- *
- */
-typedef Dart_Handle (*Dart_LibraryTagHandler)(
- Dart_LibraryTag tag,
- Dart_Handle library_or_package_map_url,
- Dart_Handle url);
-
-/**
- * Sets library tag handler for the current isolate. This handler is
- * used to handle the various tags encountered while loading libraries
- * or scripts in the isolate.
- *
- * \param handler Handler code to be used for handling the various tags
- * encountered while loading libraries or scripts in the isolate.
- *
- * \return If no error occurs, the handler is set for the isolate.
- * Otherwise an error handle is returned.
- *
- * TODO(turnidge): Document.
- */
-DART_EXPORT Dart_Handle
-Dart_SetLibraryTagHandler(Dart_LibraryTagHandler handler);
-
-/**
- * Handles deferred loading requests. When this handler is invoked, it should
- * eventually load the deferred loading unit with the given id and call
- * Dart_DeferredLoadComplete or Dart_DeferredLoadCompleteError. It is
- * recommended that the loading occur asynchronously, but it is permitted to
- * call Dart_DeferredLoadComplete or Dart_DeferredLoadCompleteError before the
- * handler returns.
- *
- * If an error is returned, it will be propagated through
- * `prefix.loadLibrary()`. This is useful for synchronous
- * implementations, which must propagate any unwind errors from
- * Dart_DeferredLoadComplete or Dart_DeferredLoadComplete. Otherwise the handler
- * should return a non-error such as `Dart_Null()`.
- */
-typedef Dart_Handle (*Dart_DeferredLoadHandler)(intptr_t loading_unit_id);
-
-/**
- * Sets the deferred load handler for the current isolate. This handler is
- * used to handle loading deferred imports in an AppJIT or AppAOT program.
- */
-DART_EXPORT Dart_Handle
-Dart_SetDeferredLoadHandler(Dart_DeferredLoadHandler handler);
-
-/**
- * Notifies the VM that a deferred load completed successfully. This function
- * will eventually cause the corresponding `prefix.loadLibrary()` futures to
- * complete.
- *
- * Requires the current isolate to be the same current isolate during the
- * invocation of the Dart_DeferredLoadHandler.
- */
-DART_EXPORT DART_WARN_UNUSED_RESULT Dart_Handle
-Dart_DeferredLoadComplete(intptr_t loading_unit_id,
- const uint8_t* snapshot_data,
- const uint8_t* snapshot_instructions);
-
-/**
- * Notifies the VM that a deferred load failed. This function
- * will eventually cause the corresponding `prefix.loadLibrary()` futures to
- * complete with an error.
- *
- * If `transient` is true, future invocations of `prefix.loadLibrary()` will
- * trigger new load requests. If false, futures invocation will complete with
- * the same error.
- *
- * Requires the current isolate to be the same current isolate during the
- * invocation of the Dart_DeferredLoadHandler.
- */
-DART_EXPORT DART_WARN_UNUSED_RESULT Dart_Handle
-Dart_DeferredLoadCompleteError(intptr_t loading_unit_id,
- const char* error_message,
- bool transient);
-
-/**
- * Canonicalizes a url with respect to some library.
- *
- * The url is resolved with respect to the library's url and some url
- * normalizations are performed.
- *
- * This canonicalization function should be sufficient for most
- * embedders to implement the Dart_kCanonicalizeUrl tag.
- *
- * \param base_url The base url relative to which the url is
- * being resolved.
- * \param url The url being resolved and canonicalized. This
- * parameter is a string handle.
- *
- * \return If no error occurs, a String object is returned. Otherwise
- * an error handle is returned.
- */
-DART_EXPORT Dart_Handle Dart_DefaultCanonicalizeUrl(Dart_Handle base_url,
- Dart_Handle url);
-
-/**
- * Loads the root library for the current isolate.
- *
- * Requires there to be no current root library.
- *
- * \param kernel_buffer A buffer which contains a kernel binary (see
- * pkg/kernel/binary.md). Must remain valid until isolate group shutdown.
- * \param kernel_size Length of the passed in buffer.
- *
- * \return A handle to the root library, or an error.
- */
-DART_EXPORT DART_WARN_UNUSED_RESULT Dart_Handle
-Dart_LoadScriptFromKernel(const uint8_t* kernel_buffer, intptr_t kernel_size);
-
-/**
- * Gets the library for the root script for the current isolate.
- *
- * If the root script has not yet been set for the current isolate,
- * this function returns Dart_Null(). This function never returns an
- * error handle.
- *
- * \return Returns the root Library for the current isolate or Dart_Null().
- */
-DART_EXPORT Dart_Handle Dart_RootLibrary(void);
-
-/**
- * Sets the root library for the current isolate.
- *
- * \return Returns an error handle if `library` is not a library handle.
- */
-DART_EXPORT Dart_Handle Dart_SetRootLibrary(Dart_Handle library);
-
-/**
- * Lookup or instantiate a legacy type by name and type arguments from a
- * Library.
- *
- * \param library The library containing the class or interface.
- * \param class_name The class name for the type.
- * \param number_of_type_arguments Number of type arguments.
- * For non parametric types the number of type arguments would be 0.
- * \param type_arguments Pointer to an array of type arguments.
- * For non parameteric types a NULL would be passed in for this argument.
- *
- * \return If no error occurs, the type is returned.
- * Otherwise an error handle is returned.
- */
-DART_EXPORT Dart_Handle Dart_GetType(Dart_Handle library,
- Dart_Handle class_name,
- intptr_t number_of_type_arguments,
- Dart_Handle* type_arguments);
-
-/**
- * Lookup or instantiate a nullable type by name and type arguments from
- * Library.
- *
- * \param library The library containing the class or interface.
- * \param class_name The class name for the type.
- * \param number_of_type_arguments Number of type arguments.
- * For non parametric types the number of type arguments would be 0.
- * \param type_arguments Pointer to an array of type arguments.
- * For non parameteric types a NULL would be passed in for this argument.
- *
- * \return If no error occurs, the type is returned.
- * Otherwise an error handle is returned.
- */
-DART_EXPORT Dart_Handle Dart_GetNullableType(Dart_Handle library,
- Dart_Handle class_name,
- intptr_t number_of_type_arguments,
- Dart_Handle* type_arguments);
-
-/**
- * Lookup or instantiate a non-nullable type by name and type arguments from
- * Library.
- *
- * \param library The library containing the class or interface.
- * \param class_name The class name for the type.
- * \param number_of_type_arguments Number of type arguments.
- * For non parametric types the number of type arguments would be 0.
- * \param type_arguments Pointer to an array of type arguments.
- * For non parameteric types a NULL would be passed in for this argument.
- *
- * \return If no error occurs, the type is returned.
- * Otherwise an error handle is returned.
- */
-DART_EXPORT Dart_Handle
-Dart_GetNonNullableType(Dart_Handle library,
- Dart_Handle class_name,
- intptr_t number_of_type_arguments,
- Dart_Handle* type_arguments);
-
-/**
- * Creates a nullable version of the provided type.
- *
- * \param type The type to be converted to a nullable type.
- *
- * \return If no error occurs, a nullable type is returned.
- * Otherwise an error handle is returned.
- */
-DART_EXPORT Dart_Handle Dart_TypeToNullableType(Dart_Handle type);
-
-/**
- * Creates a non-nullable version of the provided type.
- *
- * \param type The type to be converted to a non-nullable type.
- *
- * \return If no error occurs, a non-nullable type is returned.
- * Otherwise an error handle is returned.
- */
-DART_EXPORT Dart_Handle Dart_TypeToNonNullableType(Dart_Handle type);
-
-/**
- * A type's nullability.
- *
- * \param type A Dart type.
- * \param result An out parameter containing the result of the check. True if
- * the type is of the specified nullability, false otherwise.
- *
- * \return Returns an error handle if type is not of type Type.
- */
-DART_EXPORT Dart_Handle Dart_IsNullableType(Dart_Handle type, bool* result);
-DART_EXPORT Dart_Handle Dart_IsNonNullableType(Dart_Handle type, bool* result);
-DART_EXPORT Dart_Handle Dart_IsLegacyType(Dart_Handle type, bool* result);
-
-/**
- * Lookup a class or interface by name from a Library.
- *
- * \param library The library containing the class or interface.
- * \param class_name The name of the class or interface.
- *
- * \return If no error occurs, the class or interface is
- * returned. Otherwise an error handle is returned.
- */
-DART_EXPORT Dart_Handle Dart_GetClass(Dart_Handle library,
- Dart_Handle class_name);
-/* TODO(asiva): The above method needs to be removed once all uses
- * of it are removed from the embedder code. */
-
-/**
- * Returns an import path to a Library, such as "file:///test.dart" or
- * "dart:core".
- */
-DART_EXPORT Dart_Handle Dart_LibraryUrl(Dart_Handle library);
-
-/**
- * Returns a URL from which a Library was loaded.
- */
-DART_EXPORT Dart_Handle Dart_LibraryResolvedUrl(Dart_Handle library);
-
-/**
- * \return An array of libraries.
- */
-DART_EXPORT Dart_Handle Dart_GetLoadedLibraries(void);
-
-DART_EXPORT Dart_Handle Dart_LookupLibrary(Dart_Handle url);
-/* TODO(turnidge): Consider returning Dart_Null() when the library is
- * not found to distinguish that from a true error case. */
-
-/**
- * Report an loading error for the library.
- *
- * \param library The library that failed to load.
- * \param error The Dart error instance containing the load error.
- *
- * \return If the VM handles the error, the return value is
- * a null handle. If it doesn't handle the error, the error
- * object is returned.
- */
-DART_EXPORT Dart_Handle Dart_LibraryHandleError(Dart_Handle library,
- Dart_Handle error);
-
-/**
- * Called by the embedder to load a partial program. Does not set the root
- * library.
- *
- * \param kernel_buffer A buffer which contains a kernel binary (see
- * pkg/kernel/binary.md). Must remain valid until isolate shutdown.
- * \param kernel_buffer_size Length of the passed in buffer.
- *
- * \return A handle to the main library of the compilation unit, or an error.
- */
-DART_EXPORT DART_WARN_UNUSED_RESULT Dart_Handle
-Dart_LoadLibraryFromKernel(const uint8_t* kernel_buffer,
- intptr_t kernel_buffer_size);
-
-/**
- * Indicates that all outstanding load requests have been satisfied.
- * This finalizes all the new classes loaded and optionally completes
- * deferred library futures.
- *
- * Requires there to be a current isolate.
- *
- * \param complete_futures Specify true if all deferred library
- * futures should be completed, false otherwise.
- *
- * \return Success if all classes have been finalized and deferred library
- * futures are completed. Otherwise, returns an error.
- */
-DART_EXPORT DART_WARN_UNUSED_RESULT Dart_Handle
-Dart_FinalizeLoading(bool complete_futures);
-
-/*
- * =====
- * Peers
- * =====
- */
-
-/**
- * The peer field is a lazily allocated field intended for storage of
- * an uncommonly used values. Most instances types can have a peer
- * field allocated. The exceptions are subtypes of Null, num, and
- * bool.
- */
-
-/**
- * Returns the value of peer field of 'object' in 'peer'.
- *
- * \param object An object.
- * \param peer An out parameter that returns the value of the peer
- * field.
- *
- * \return Returns an error if 'object' is a subtype of Null, num, or
- * bool.
- */
-DART_EXPORT Dart_Handle Dart_GetPeer(Dart_Handle object, void** peer);
-
-/**
- * Sets the value of the peer field of 'object' to the value of
- * 'peer'.
- *
- * \param object An object.
- * \param peer A value to store in the peer field.
- *
- * \return Returns an error if 'object' is a subtype of Null, num, or
- * bool.
- */
-DART_EXPORT Dart_Handle Dart_SetPeer(Dart_Handle object, void* peer);
-
-/*
- * ======
- * Kernel
- * ======
- */
-
-/**
- * Experimental support for Dart to Kernel parser isolate.
- *
- * TODO(hausner): Document finalized interface.
- *
- */
-
-// TODO(33433): Remove kernel service from the embedding API.
-
-typedef enum {
- Dart_KernelCompilationStatus_Unknown = -1,
- Dart_KernelCompilationStatus_Ok = 0,
- Dart_KernelCompilationStatus_Error = 1,
- Dart_KernelCompilationStatus_Crash = 2,
- Dart_KernelCompilationStatus_MsgFailed = 3,
-} Dart_KernelCompilationStatus;
-
-typedef struct {
- Dart_KernelCompilationStatus status;
- bool null_safety;
- char* error;
- uint8_t* kernel;
- intptr_t kernel_size;
-} Dart_KernelCompilationResult;
-
-typedef enum {
- Dart_KernelCompilationVerbosityLevel_Error = 0,
- Dart_KernelCompilationVerbosityLevel_Warning,
- Dart_KernelCompilationVerbosityLevel_Info,
- Dart_KernelCompilationVerbosityLevel_All,
-} Dart_KernelCompilationVerbosityLevel;
-
-DART_EXPORT bool Dart_IsKernelIsolate(Dart_Isolate isolate);
-DART_EXPORT bool Dart_KernelIsolateIsRunning(void);
-DART_EXPORT Dart_Port Dart_KernelPort(void);
-
-/**
- * Compiles the given `script_uri` to a kernel file.
- *
- * \param platform_kernel A buffer containing the kernel of the platform (e.g.
- * `vm_platform_strong.dill`). The VM does not take ownership of this memory.
- *
- * \param platform_kernel_size The length of the platform_kernel buffer.
- *
- * \param snapshot_compile Set to `true` when the compilation is for a snapshot.
- * This is used by the frontend to determine if compilation related information
- * should be printed to console (e.g., null safety mode).
- *
- * \param verbosity Specifies the logging behavior of the kernel compilation
- * service.
- *
- * \return Returns the result of the compilation.
- *
- * On a successful compilation the returned [Dart_KernelCompilationResult] has
- * a status of [Dart_KernelCompilationStatus_Ok] and the `kernel`/`kernel_size`
- * fields are set. The caller takes ownership of the malloc()ed buffer.
- *
- * On a failed compilation the `error` might be set describing the reason for
- * the failed compilation. The caller takes ownership of the malloc()ed
- * error.
- *
- * Requires there to be a current isolate.
- */
-DART_EXPORT Dart_KernelCompilationResult
-Dart_CompileToKernel(const char* script_uri,
- const uint8_t* platform_kernel,
- const intptr_t platform_kernel_size,
- bool incremental_compile,
- bool snapshot_compile,
- const char* package_config,
- Dart_KernelCompilationVerbosityLevel verbosity);
-
-/**
- * Compiles the given `script_uri` to a kernel file.
- *
- * \param platform_kernel A buffer containing the kernel of the platform (e.g.
- * `vm_platform_strong.dill`). The VM does not take ownership of this memory.
- *
- * \param platform_kernel_size The length of the platform_kernel buffer.
- *
- * \param snapshot_compile Set to `true` when the compilation is for a snapshot.
- * This is used by the frontend to determine if compilation related information
- * should be printed to console (e.g., null safety mode).
- *
- * \param null_safety Provides null-safety mode setting for the compiler.
- *
- * \param verbosity Specifies the logging behavior of the kernel compilation
- * service.
- *
- * \return Returns the result of the compilation.
- *
- * On a successful compilation the returned [Dart_KernelCompilationResult] has
- * a status of [Dart_KernelCompilationStatus_Ok] and the `kernel`/`kernel_size`
- * fields are set. The caller takes ownership of the malloc()ed buffer.
- *
- * On a failed compilation the `error` might be set describing the reason for
- * the failed compilation. The caller takes ownership of the malloc()ed
- * error.
- */
-DART_EXPORT Dart_KernelCompilationResult
-Dart_CompileToKernelWithGivenNullsafety(
- const char* script_uri,
- const uint8_t* platform_kernel,
- const intptr_t platform_kernel_size,
- bool snapshot_compile,
- const char* package_config,
- const bool null_safety,
- Dart_KernelCompilationVerbosityLevel verbosity);
-
-typedef struct {
- const char* uri;
- const char* source;
-} Dart_SourceFile;
-
-DART_EXPORT Dart_KernelCompilationResult Dart_KernelListDependencies(void);
-
-/**
- * Sets the kernel buffer which will be used to load Dart SDK sources
- * dynamically at runtime.
- *
- * \param platform_kernel A buffer containing kernel which has sources for the
- * Dart SDK populated. Note: The VM does not take ownership of this memory.
- *
- * \param platform_kernel_size The length of the platform_kernel buffer.
- */
-DART_EXPORT void Dart_SetDartLibrarySourcesKernel(
- const uint8_t* platform_kernel,
- const intptr_t platform_kernel_size);
-
-/**
- * Detect the null safety opt-in status.
- *
- * When running from source, it is based on the opt-in status of `script_uri`.
- * When running from a kernel buffer, it is based on the mode used when
- * generating `kernel_buffer`.
- * When running from an appJIT or AOT snapshot, it is based on the mode used
- * when generating `snapshot_data`.
- *
- * \param script_uri Uri of the script that contains the source code
- *
- * \param package_config Uri of the package configuration file (either in format
- * of .packages or .dart_tool/package_config.json) for the null safety
- * detection to resolve package imports against. If this parameter is not
- * passed the package resolution of the parent isolate should be used.
- *
- * \param original_working_directory current working directory when the VM
- * process was launched, this is used to correctly resolve the path specified
- * for package_config.
- *
- * \param snapshot_data Buffer containing the snapshot data of the
- * isolate or NULL if no snapshot is provided. If provided, the buffers must
- * remain valid until the isolate shuts down.
- *
- * \param snapshot_instructions Buffer containing the snapshot instructions of
- * the isolate or NULL if no snapshot is provided. If provided, the buffers
- * must remain valid until the isolate shuts down.
- *
- * \param kernel_buffer A buffer which contains a kernel/DIL program. Must
- * remain valid until isolate shutdown.
- *
- * \param kernel_buffer_size The size of `kernel_buffer`.
- *
- * \return Returns true if the null safety is opted in by the input being
- * run `script_uri`, `snapshot_data` or `kernel_buffer`.
- *
- */
-DART_EXPORT bool Dart_DetectNullSafety(const char* script_uri,
- const char* package_config,
- const char* original_working_directory,
- const uint8_t* snapshot_data,
- const uint8_t* snapshot_instructions,
- const uint8_t* kernel_buffer,
- intptr_t kernel_buffer_size);
-
-#define DART_KERNEL_ISOLATE_NAME "kernel-service"
-
-/*
- * =======
- * Service
- * =======
- */
-
-#define DART_VM_SERVICE_ISOLATE_NAME "vm-service"
-
-/**
- * Returns true if isolate is the service isolate.
- *
- * \param isolate An isolate
- *
- * \return Returns true if 'isolate' is the service isolate.
- */
-DART_EXPORT bool Dart_IsServiceIsolate(Dart_Isolate isolate);
-
-/**
- * Writes the CPU profile to the timeline as a series of 'instant' events.
- *
- * Note that this is an expensive operation.
- *
- * \param main_port The main port of the Isolate whose profile samples to write.
- * \param error An optional error, must be free()ed by caller.
- *
- * \return Returns true if the profile is successfully written and false
- * otherwise.
- */
-DART_EXPORT bool Dart_WriteProfileToTimeline(Dart_Port main_port, char** error);
-
-/*
- * ==============
- * Precompilation
- * ==============
- */
-
-/**
- * Compiles all functions reachable from entry points and marks
- * the isolate to disallow future compilation.
- *
- * Entry points should be specified using `@pragma("vm:entry-point")`
- * annotation.
- *
- * \return An error handle if a compilation error or runtime error running const
- * constructors was encountered.
- */
-DART_EXPORT Dart_Handle Dart_Precompile(void);
-
-typedef void (*Dart_CreateLoadingUnitCallback)(
- void* callback_data,
- intptr_t loading_unit_id,
- void** write_callback_data,
- void** write_debug_callback_data);
-typedef void (*Dart_StreamingWriteCallback)(void* callback_data,
- const uint8_t* buffer,
- intptr_t size);
-typedef void (*Dart_StreamingCloseCallback)(void* callback_data);
-
-DART_EXPORT Dart_Handle Dart_LoadingUnitLibraryUris(intptr_t loading_unit_id);
-
-// On Darwin systems, 'dlsym' adds an '_' to the beginning of the symbol name.
-// Use the '...CSymbol' definitions for resolving through 'dlsym'. The actual
-// symbol names in the objects are given by the '...AsmSymbol' definitions.
-#if defined(__APPLE__)
-#define kSnapshotBuildIdCSymbol "kDartSnapshotBuildId"
-#define kVmSnapshotDataCSymbol "kDartVmSnapshotData"
-#define kVmSnapshotInstructionsCSymbol "kDartVmSnapshotInstructions"
-#define kVmSnapshotBssCSymbol "kDartVmSnapshotBss"
-#define kIsolateSnapshotDataCSymbol "kDartIsolateSnapshotData"
-#define kIsolateSnapshotInstructionsCSymbol "kDartIsolateSnapshotInstructions"
-#define kIsolateSnapshotBssCSymbol "kDartIsolateSnapshotBss"
-#else
-#define kSnapshotBuildIdCSymbol "_kDartSnapshotBuildId"
-#define kVmSnapshotDataCSymbol "_kDartVmSnapshotData"
-#define kVmSnapshotInstructionsCSymbol "_kDartVmSnapshotInstructions"
-#define kVmSnapshotBssCSymbol "_kDartVmSnapshotBss"
-#define kIsolateSnapshotDataCSymbol "_kDartIsolateSnapshotData"
-#define kIsolateSnapshotInstructionsCSymbol "_kDartIsolateSnapshotInstructions"
-#define kIsolateSnapshotBssCSymbol "_kDartIsolateSnapshotBss"
-#endif
-
-#define kSnapshotBuildIdAsmSymbol "_kDartSnapshotBuildId"
-#define kVmSnapshotDataAsmSymbol "_kDartVmSnapshotData"
-#define kVmSnapshotInstructionsAsmSymbol "_kDartVmSnapshotInstructions"
-#define kVmSnapshotBssAsmSymbol "_kDartVmSnapshotBss"
-#define kIsolateSnapshotDataAsmSymbol "_kDartIsolateSnapshotData"
-#define kIsolateSnapshotInstructionsAsmSymbol \
- "_kDartIsolateSnapshotInstructions"
-#define kIsolateSnapshotBssAsmSymbol "_kDartIsolateSnapshotBss"
-
-/**
- * Creates a precompiled snapshot.
- * - A root library must have been loaded.
- * - Dart_Precompile must have been called.
- *
- * Outputs an assembly file defining the symbols listed in the definitions
- * above.
- *
- * The assembly should be compiled as a static or shared library and linked or
- * loaded by the embedder. Running this snapshot requires a VM compiled with
- * DART_PRECOMPILED_SNAPSHOT. The kDartVmSnapshotData and
- * kDartVmSnapshotInstructions should be passed to Dart_Initialize. The
- * kDartIsolateSnapshotData and kDartIsolateSnapshotInstructions should be
- * passed to Dart_CreateIsolateGroup.
- *
- * The callback will be invoked one or more times to provide the assembly code.
- *
- * If stripped is true, then the assembly code will not include DWARF
- * debugging sections.
- *
- * If debug_callback_data is provided, debug_callback_data will be used with
- * the callback to provide separate debugging information.
- *
- * \return A valid handle if no error occurs during the operation.
- */
-DART_EXPORT DART_WARN_UNUSED_RESULT Dart_Handle
-Dart_CreateAppAOTSnapshotAsAssembly(Dart_StreamingWriteCallback callback,
- void* callback_data,
- bool stripped,
- void* debug_callback_data);
-DART_EXPORT DART_WARN_UNUSED_RESULT Dart_Handle
-Dart_CreateAppAOTSnapshotAsAssemblies(
- Dart_CreateLoadingUnitCallback next_callback,
- void* next_callback_data,
- bool stripped,
- Dart_StreamingWriteCallback write_callback,
- Dart_StreamingCloseCallback close_callback);
-
-/**
- * Creates a precompiled snapshot.
- * - A root library must have been loaded.
- * - Dart_Precompile must have been called.
- *
- * Outputs an ELF shared library defining the symbols
- * - _kDartVmSnapshotData
- * - _kDartVmSnapshotInstructions
- * - _kDartIsolateSnapshotData
- * - _kDartIsolateSnapshotInstructions
- *
- * The shared library should be dynamically loaded by the embedder.
- * Running this snapshot requires a VM compiled with DART_PRECOMPILED_SNAPSHOT.
- * The kDartVmSnapshotData and kDartVmSnapshotInstructions should be passed to
- * Dart_Initialize. The kDartIsolateSnapshotData and
- * kDartIsolateSnapshotInstructions should be passed to Dart_CreateIsolate.
- *
- * The callback will be invoked one or more times to provide the binary output.
- *
- * If stripped is true, then the binary output will not include DWARF
- * debugging sections.
- *
- * If debug_callback_data is provided, debug_callback_data will be used with
- * the callback to provide separate debugging information.
- *
- * \return A valid handle if no error occurs during the operation.
- */
-DART_EXPORT DART_WARN_UNUSED_RESULT Dart_Handle
-Dart_CreateAppAOTSnapshotAsElf(Dart_StreamingWriteCallback callback,
- void* callback_data,
- bool stripped,
- void* debug_callback_data);
-DART_EXPORT DART_WARN_UNUSED_RESULT Dart_Handle
-Dart_CreateAppAOTSnapshotAsElfs(Dart_CreateLoadingUnitCallback next_callback,
- void* next_callback_data,
- bool stripped,
- Dart_StreamingWriteCallback write_callback,
- Dart_StreamingCloseCallback close_callback);
-
-/**
- * Like Dart_CreateAppAOTSnapshotAsAssembly, but only includes
- * kDartVmSnapshotData and kDartVmSnapshotInstructions. It also does
- * not strip DWARF information from the generated assembly or allow for
- * separate debug information.
- */
-DART_EXPORT DART_WARN_UNUSED_RESULT Dart_Handle
-Dart_CreateVMAOTSnapshotAsAssembly(Dart_StreamingWriteCallback callback,
- void* callback_data);
-
-/**
- * Sorts the class-ids in depth first traversal order of the inheritance
- * tree. This is a costly operation, but it can make method dispatch
- * more efficient and is done before writing snapshots.
- *
- * \return A valid handle if no error occurs during the operation.
- */
-DART_EXPORT DART_WARN_UNUSED_RESULT Dart_Handle Dart_SortClasses(void);
-
-/**
- * Creates a snapshot that caches compiled code and type feedback for faster
- * startup and quicker warmup in a subsequent process.
- *
- * Outputs a snapshot in two pieces. The pieces should be passed to
- * Dart_CreateIsolateGroup in a VM using the same VM snapshot pieces used in the
- * current VM. The instructions piece must be loaded with read and execute
- * permissions; the data piece may be loaded as read-only.
- *
- * - Requires the VM to have not been started with --precompilation.
- * - Not supported when targeting IA32.
- * - The VM writing the snapshot and the VM reading the snapshot must be the
- * same version, must be built in the same DEBUG/RELEASE/PRODUCT mode, must
- * be targeting the same architecture, and must both be in checked mode or
- * both in unchecked mode.
- *
- * The buffers are scope allocated and are only valid until the next call to
- * Dart_ExitScope.
- *
- * \return A valid handle if no error occurs during the operation.
- */
-DART_EXPORT DART_WARN_UNUSED_RESULT Dart_Handle
-Dart_CreateAppJITSnapshotAsBlobs(uint8_t** isolate_snapshot_data_buffer,
- intptr_t* isolate_snapshot_data_size,
- uint8_t** isolate_snapshot_instructions_buffer,
- intptr_t* isolate_snapshot_instructions_size);
-
-/**
- * Like Dart_CreateAppJITSnapshotAsBlobs, but also creates a new VM snapshot.
- */
-DART_EXPORT DART_WARN_UNUSED_RESULT Dart_Handle
-Dart_CreateCoreJITSnapshotAsBlobs(
- uint8_t** vm_snapshot_data_buffer,
- intptr_t* vm_snapshot_data_size,
- uint8_t** vm_snapshot_instructions_buffer,
- intptr_t* vm_snapshot_instructions_size,
- uint8_t** isolate_snapshot_data_buffer,
- intptr_t* isolate_snapshot_data_size,
- uint8_t** isolate_snapshot_instructions_buffer,
- intptr_t* isolate_snapshot_instructions_size);
-
-/**
- * Get obfuscation map for precompiled code.
- *
- * Obfuscation map is encoded as a JSON array of pairs (original name,
- * obfuscated name).
- *
- * \return Returns an error handler if the VM was built in a mode that does not
- * support obfuscation.
- */
-DART_EXPORT DART_WARN_UNUSED_RESULT Dart_Handle
-Dart_GetObfuscationMap(uint8_t** buffer, intptr_t* buffer_length);
-
-/**
- * Returns whether the VM only supports running from precompiled snapshots and
- * not from any other kind of snapshot or from source (that is, the VM was
- * compiled with DART_PRECOMPILED_RUNTIME).
- */
-DART_EXPORT bool Dart_IsPrecompiledRuntime(void);
-
-/**
- * Print a native stack trace. Used for crash handling.
- *
- * If context is NULL, prints the current stack trace. Otherwise, context
- * should be a CONTEXT* (Windows) or ucontext_t* (POSIX) from a signal handler
- * running on the current thread.
- */
-DART_EXPORT void Dart_DumpNativeStackTrace(void* context);
-
-/**
- * Indicate that the process is about to abort, and the Dart VM should not
- * attempt to cleanup resources.
- */
-DART_EXPORT void Dart_PrepareToAbort(void);
-
-#endif /* INCLUDE_DART_API_H_ */ /* NOLINT */
diff --git a/experimental/pedometer/src/health_connect/include/dart_api_dl.c b/experimental/pedometer/src/health_connect/include/dart_api_dl.c
deleted file mode 100644
index c4a68f444..000000000
--- a/experimental/pedometer/src/health_connect/include/dart_api_dl.c
+++ /dev/null
@@ -1,59 +0,0 @@
-/*
- * Copyright (c) 2020, the Dart project authors. Please see the AUTHORS file
- * for details. All rights reserved. Use of this source code is governed by a
- * BSD-style license that can be found in the LICENSE file.
- */
-
-#include "dart_api_dl.h" /* NOLINT */
-#include "dart_version.h" /* NOLINT */
-#include "internal/dart_api_dl_impl.h" /* NOLINT */
-
-#include <string.h>
-
-#define DART_API_DL_DEFINITIONS(name, R, A) name##_Type name##_DL = NULL;
-
-DART_API_ALL_DL_SYMBOLS(DART_API_DL_DEFINITIONS)
-
-#undef DART_API_DL_DEFINITIONS
-
-typedef void* DartApiEntry_function;
-
-DartApiEntry_function FindFunctionPointer(const DartApiEntry* entries,
- const char* name) {
- while (entries->name != NULL) {
- if (strcmp(entries->name, name) == 0) return entries->function;
- entries++;
- }
- return NULL;
-}
-
-intptr_t Dart_InitializeApiDL(void* data) {
- DartApi* dart_api_data = (DartApi*)data;
-
- if (dart_api_data->major != DART_API_DL_MAJOR_VERSION) {
- // If the DartVM we're running on does not have the same version as this
- // file was compiled against, refuse to initialize. The symbols are not
- // compatible.
- return -1;
- }
- // Minor versions are allowed to be different.
- // If the DartVM has a higher minor version, it will provide more symbols
- // than we initialize here.
- // If the DartVM has a lower minor version, it will not provide all symbols.
- // In that case, we leave the missing symbols un-initialized. Those symbols
- // should not be used by the Dart and native code. The client is responsible
- // for checking the minor version number himself based on which symbols it
- // is using.
- // (If we would error out on this case, recompiling native code against a
- // newer SDK would break all uses on older SDKs, which is too strict.)
-
- const DartApiEntry* dart_api_function_pointers = dart_api_data->functions;
-
-#define DART_API_DL_INIT(name, R, A) \
- name##_DL = \
- (name##_Type)(FindFunctionPointer(dart_api_function_pointers, #name));
- DART_API_ALL_DL_SYMBOLS(DART_API_DL_INIT)
-#undef DART_API_DL_INIT
-
- return 0;
-}
diff --git a/experimental/pedometer/src/health_connect/include/dart_api_dl.h b/experimental/pedometer/src/health_connect/include/dart_api_dl.h
deleted file mode 100644
index 804b2811c..000000000
--- a/experimental/pedometer/src/health_connect/include/dart_api_dl.h
+++ /dev/null
@@ -1,150 +0,0 @@
-/*
- * Copyright (c) 2020, the Dart project authors. Please see the AUTHORS file
- * for details. All rights reserved. Use of this source code is governed by a
- * BSD-style license that can be found in the LICENSE file.
- */
-
-#ifndef RUNTIME_INCLUDE_DART_API_DL_H_
-#define RUNTIME_INCLUDE_DART_API_DL_H_
-
-#include "dart_api.h" /* NOLINT */
-#include "dart_native_api.h" /* NOLINT */
-
-/** \mainpage Dynamically Linked Dart API
- *
- * This exposes a subset of symbols from dart_api.h and dart_native_api.h
- * available in every Dart embedder through dynamic linking.
- *
- * All symbols are postfixed with _DL to indicate that they are dynamically
- * linked and to prevent conflicts with the original symbol.
- *
- * Link `dart_api_dl.c` file into your library and invoke
- * `Dart_InitializeApiDL` with `NativeApi.initializeApiDLData`.
- */
-
-DART_EXPORT intptr_t Dart_InitializeApiDL(void* data);
-
-// ============================================================================
-// IMPORTANT! Never update these signatures without properly updating
-// DART_API_DL_MAJOR_VERSION and DART_API_DL_MINOR_VERSION.
-//
-// Verbatim copy of `dart_native_api.h` and `dart_api.h` symbol names and types
-// to trigger compile-time errors if the sybols in those files are updated
-// without updating these.
-//
-// Function return and argument types, and typedefs are carbon copied. Structs
-// are typechecked nominally in C/C++, so they are not copied, instead a
-// comment is added to their definition.
-typedef int64_t Dart_Port_DL;
-
-typedef void (*Dart_NativeMessageHandler_DL)(Dart_Port_DL dest_port_id,
- Dart_CObject* message);
-
-// dart_native_api.h symbols can be called on any thread.
-#define DART_NATIVE_API_DL_SYMBOLS(F) \
- /***** dart_native_api.h *****/ \
- /* Dart_Port */ \
- F(Dart_PostCObject, bool, (Dart_Port_DL port_id, Dart_CObject * message)) \
- F(Dart_PostInteger, bool, (Dart_Port_DL port_id, int64_t message)) \
- F(Dart_NewNativePort, Dart_Port_DL, \
- (const char* name, Dart_NativeMessageHandler_DL handler, \
- bool handle_concurrently)) \
- F(Dart_CloseNativePort, bool, (Dart_Port_DL native_port_id))
-
-// dart_api.h symbols can only be called on Dart threads.
-#define DART_API_DL_SYMBOLS(F) \
- /***** dart_api.h *****/ \
- /* Errors */ \
- F(Dart_IsError, bool, (Dart_Handle handle)) \
- F(Dart_IsApiError, bool, (Dart_Handle handle)) \
- F(Dart_IsUnhandledExceptionError, bool, (Dart_Handle handle)) \
- F(Dart_IsCompilationError, bool, (Dart_Handle handle)) \
- F(Dart_IsFatalError, bool, (Dart_Handle handle)) \
- F(Dart_GetError, const char*, (Dart_Handle handle)) \
- F(Dart_ErrorHasException, bool, (Dart_Handle handle)) \
- F(Dart_ErrorGetException, Dart_Handle, (Dart_Handle handle)) \
- F(Dart_ErrorGetStackTrace, Dart_Handle, (Dart_Handle handle)) \
- F(Dart_NewApiError, Dart_Handle, (const char* error)) \
- F(Dart_NewCompilationError, Dart_Handle, (const char* error)) \
- F(Dart_NewUnhandledExceptionError, Dart_Handle, (Dart_Handle exception)) \
- F(Dart_PropagateError, void, (Dart_Handle handle)) \
- /* Dart_Handle, Dart_PersistentHandle, Dart_WeakPersistentHandle */ \
- F(Dart_HandleFromPersistent, Dart_Handle, (Dart_PersistentHandle object)) \
- F(Dart_HandleFromWeakPersistent, Dart_Handle, \
- (Dart_WeakPersistentHandle object)) \
- F(Dart_NewPersistentHandle, Dart_PersistentHandle, (Dart_Handle object)) \
- F(Dart_SetPersistentHandle, void, \
- (Dart_PersistentHandle obj1, Dart_Handle obj2)) \
- F(Dart_DeletePersistentHandle, void, (Dart_PersistentHandle object)) \
- F(Dart_NewWeakPersistentHandle, Dart_WeakPersistentHandle, \
- (Dart_Handle object, void* peer, intptr_t external_allocation_size, \
- Dart_HandleFinalizer callback)) \
- F(Dart_DeleteWeakPersistentHandle, void, (Dart_WeakPersistentHandle object)) \
- F(Dart_UpdateExternalSize, void, \
- (Dart_WeakPersistentHandle object, intptr_t external_allocation_size)) \
- F(Dart_NewFinalizableHandle, Dart_FinalizableHandle, \
- (Dart_Handle object, void* peer, intptr_t external_allocation_size, \
- Dart_HandleFinalizer callback)) \
- F(Dart_DeleteFinalizableHandle, void, \
- (Dart_FinalizableHandle object, Dart_Handle strong_ref_to_object)) \
- F(Dart_UpdateFinalizableExternalSize, void, \
- (Dart_FinalizableHandle object, Dart_Handle strong_ref_to_object, \
- intptr_t external_allocation_size)) \
- /* Dart_Port */ \
- F(Dart_Post, bool, (Dart_Port_DL port_id, Dart_Handle object)) \
- F(Dart_NewSendPort, Dart_Handle, (Dart_Port_DL port_id)) \
- F(Dart_SendPortGetId, Dart_Handle, \
- (Dart_Handle port, Dart_Port_DL * port_id)) \
- /* Scopes */ \
- F(Dart_EnterScope, void, (void)) \
- F(Dart_ExitScope, void, (void))
-
-#define DART_API_ALL_DL_SYMBOLS(F) \
- DART_NATIVE_API_DL_SYMBOLS(F) \
- DART_API_DL_SYMBOLS(F)
-// IMPORTANT! Never update these signatures without properly updating
-// DART_API_DL_MAJOR_VERSION and DART_API_DL_MINOR_VERSION.
-//
-// End of verbatim copy.
-// ============================================================================
-
-// Copy of definition of DART_EXPORT without 'used' attribute.
-//
-// The 'used' attribute cannot be used with DART_API_ALL_DL_SYMBOLS because
-// they are not function declarations, but variable declarations with a
-// function pointer type.
-//
-// The function pointer variables are initialized with the addresses of the
-// functions in the VM. If we were to use function declarations instead, we
-// would need to forward the call to the VM adding indirection.
-#if defined(__CYGWIN__)
-#error Tool chain and platform not supported.
-#elif defined(_WIN32)
-#if defined(DART_SHARED_LIB)
-#define DART_EXPORT_DL DART_EXTERN_C __declspec(dllexport)
-#else
-#define DART_EXPORT_DL DART_EXTERN_C
-#endif
-#else
-#if __GNUC__ >= 4
-#if defined(DART_SHARED_LIB)
-#define DART_EXPORT_DL DART_EXTERN_C __attribute__((visibility("default")))
-#else
-#define DART_EXPORT_DL DART_EXTERN_C
-#endif
-#else
-#error Tool chain not supported.
-#endif
-#endif
-
-#define DART_API_DL_DECLARATIONS(name, R, A) \
- typedef R(*name##_Type) A; \
- DART_EXPORT_DL name##_Type name##_DL;
-
-DART_API_ALL_DL_SYMBOLS(DART_API_DL_DECLARATIONS)
-
-#undef DART_API_DL_DECLARATIONS
-
-#undef DART_EXPORT_DL
-
-#endif /* RUNTIME_INCLUDE_DART_API_DL_H_ */ /* NOLINT */
diff --git a/experimental/pedometer/src/health_connect/include/dart_embedder_api.h b/experimental/pedometer/src/health_connect/include/dart_embedder_api.h
deleted file mode 100644
index e565ebf6e..000000000
--- a/experimental/pedometer/src/health_connect/include/dart_embedder_api.h
+++ /dev/null
@@ -1,108 +0,0 @@
-// Copyright (c) 2018, the Dart project authors. Please see the AUTHORS file
-// for details. All rights reserved. Use of this source code is governed by a
-// BSD-style license that can be found in the LICENSE file.
-
-#ifndef RUNTIME_INCLUDE_DART_EMBEDDER_API_H_
-#define RUNTIME_INCLUDE_DART_EMBEDDER_API_H_
-
-#include "include/dart_api.h"
-#include "include/dart_tools_api.h"
-
-namespace dart {
-namespace embedder {
-
-// Initialize all subsystems of the embedder.
-//
-// Must be called before the `Dart_Initialize()` call to initialize the
-// Dart VM.
-//
-// Returns true on success and false otherwise, in which case error would
-// contain error message.
-DART_WARN_UNUSED_RESULT bool InitOnce(char** error);
-
-// Cleans up all subsystems of the embedder.
-//
-// Must be called after the `Dart_Cleanup()` call to initialize the
-// Dart VM.
-void Cleanup();
-
-// Common arguments that are passed to isolate creation callback and to
-// API methods that create isolates.
-struct IsolateCreationData {
- // URI for the main script that will be running in the isolate.
- const char* script_uri;
-
- // Advisory name of the main method that will be run by isolate.
- // Only used for error messages.
- const char* main;
-
- // Isolate creation flags. Might be absent.
- Dart_IsolateFlags* flags;
-
- // Isolate group callback data.
- void* isolate_group_data;
-
- // Isolate callback data.
- void* isolate_data;
-};
-
-// Create and initialize kernel-service isolate. This method should be used
-// when VM invokes isolate creation callback with DART_KERNEL_ISOLATE_NAME as
-// script_uri.
-// The isolate is created from the given snapshot (might be kernel data or
-// app-jit snapshot).
-DART_WARN_UNUSED_RESULT Dart_Isolate
-CreateKernelServiceIsolate(const IsolateCreationData& data,
- const uint8_t* buffer,
- intptr_t buffer_size,
- char** error);
-
-// Service isolate configuration.
-struct VmServiceConfiguration {
- enum {
- kBindHttpServerToAFreePort = 0,
- kDoNotAutoStartHttpServer = -1
- };
-
- // Address to which HTTP server will be bound.
- const char* ip;
-
- // Default port. See enum above for special values.
- int port;
-
- // If non-null, connection information for the VM service will be output to a
- // file in JSON format at the location specified.
- const char* write_service_info_filename;
-
- // TODO(vegorov) document these ones.
- bool dev_mode;
- bool deterministic;
- bool disable_auth_codes;
-};
-
-// Create and initialize vm-service isolate from the given AOT snapshot, which
-// is expected to contain all necessary 'vm-service' libraries.
-// This method should be used when VM invokes isolate creation callback with
-// DART_VM_SERVICE_ISOLATE_NAME as script_uri.
-DART_WARN_UNUSED_RESULT Dart_Isolate
-CreateVmServiceIsolate(const IsolateCreationData& data,
- const VmServiceConfiguration& config,
- const uint8_t* isolate_data,
- const uint8_t* isolate_instr,
- char** error);
-
-// Create and initialize vm-service isolate from the given kernel binary, which
-// is expected to contain all necessary 'vm-service' libraries.
-// This method should be used when VM invokes isolate creation callback with
-// DART_VM_SERVICE_ISOLATE_NAME as script_uri.
-DART_WARN_UNUSED_RESULT Dart_Isolate
-CreateVmServiceIsolateFromKernel(const IsolateCreationData& data,
- const VmServiceConfiguration& config,
- const uint8_t* kernel_buffer,
- intptr_t kernel_buffer_size,
- char** error);
-
-} // namespace embedder
-} // namespace dart
-
-#endif // RUNTIME_INCLUDE_DART_EMBEDDER_API_H_
diff --git a/experimental/pedometer/src/health_connect/include/dart_native_api.h b/experimental/pedometer/src/health_connect/include/dart_native_api.h
deleted file mode 100644
index 318a4b735..000000000
--- a/experimental/pedometer/src/health_connect/include/dart_native_api.h
+++ /dev/null
@@ -1,205 +0,0 @@
-/*
- * Copyright (c) 2013, the Dart project authors. Please see the AUTHORS file
- * for details. All rights reserved. Use of this source code is governed by a
- * BSD-style license that can be found in the LICENSE file.
- */
-
-#ifndef RUNTIME_INCLUDE_DART_NATIVE_API_H_
-#define RUNTIME_INCLUDE_DART_NATIVE_API_H_
-
-#include "dart_api.h" /* NOLINT */
-
-/*
- * ==========================================
- * Message sending/receiving from native code
- * ==========================================
- */
-
-/**
- * A Dart_CObject is used for representing Dart objects as native C
- * data outside the Dart heap. These objects are totally detached from
- * the Dart heap. Only a subset of the Dart objects have a
- * representation as a Dart_CObject.
- *
- * The string encoding in the 'value.as_string' is UTF-8.
- *
- * All the different types from dart:typed_data are exposed as type
- * kTypedData. The specific type from dart:typed_data is in the type
- * field of the as_typed_data structure. The length in the
- * as_typed_data structure is always in bytes.
- *
- * The data for kTypedData is copied on message send and ownership remains with
- * the caller. The ownership of data for kExternalTyped is passed to the VM on
- * message send and returned when the VM invokes the
- * Dart_HandleFinalizer callback; a non-NULL callback must be provided.
- *
- * Note that Dart_CObject_kNativePointer is intended for internal use by
- * dart:io implementation and has no connection to dart:ffi Pointer class.
- * It represents a pointer to a native resource of a known type.
- * The receiving side will only see this pointer as an integer and will not
- * see the specified finalizer.
- * The specified finalizer will only be invoked if the message is not delivered.
- */
-typedef enum {
- Dart_CObject_kNull = 0,
- Dart_CObject_kBool,
- Dart_CObject_kInt32,
- Dart_CObject_kInt64,
- Dart_CObject_kDouble,
- Dart_CObject_kString,
- Dart_CObject_kArray,
- Dart_CObject_kTypedData,
- Dart_CObject_kExternalTypedData,
- Dart_CObject_kUnmodifiableExternalTypedData,
- Dart_CObject_kSendPort,
- Dart_CObject_kCapability,
- Dart_CObject_kNativePointer,
- Dart_CObject_kUnsupported,
- Dart_CObject_kNumberOfTypes
-} Dart_CObject_Type;
-
-typedef struct _Dart_CObject {
- Dart_CObject_Type type;
- union {
- bool as_bool;
- int32_t as_int32;
- int64_t as_int64;
- double as_double;
- char* as_string;
- struct {
- Dart_Port id;
- Dart_Port origin_id;
- } as_send_port;
- struct {
- int64_t id;
- } as_capability;
- struct {
- intptr_t length;
- struct _Dart_CObject** values;
- } as_array;
- struct {
- Dart_TypedData_Type type;
- intptr_t length; /* in elements, not bytes */
- const uint8_t* values;
- } as_typed_data;
- struct {
- Dart_TypedData_Type type;
- intptr_t length; /* in elements, not bytes */
- uint8_t* data;
- void* peer;
- Dart_HandleFinalizer callback;
- } as_external_typed_data;
- struct {
- intptr_t ptr;
- intptr_t size;
- Dart_HandleFinalizer callback;
- } as_native_pointer;
- } value;
-} Dart_CObject;
-// This struct is versioned by DART_API_DL_MAJOR_VERSION, bump the version when
-// changing this struct.
-
-/**
- * Posts a message on some port. The message will contain the Dart_CObject
- * object graph rooted in 'message'.
- *
- * While the message is being sent the state of the graph of Dart_CObject
- * structures rooted in 'message' should not be accessed, as the message
- * generation will make temporary modifications to the data. When the message
- * has been sent the graph will be fully restored.
- *
- * If true is returned, the message was enqueued, and finalizers for external
- * typed data will eventually run, even if the receiving isolate shuts down
- * before processing the message. If false is returned, the message was not
- * enqueued and ownership of external typed data in the message remains with the
- * caller.
- *
- * This function may be called on any thread when the VM is running (that is,
- * after Dart_Initialize has returned and before Dart_Cleanup has been called).
- *
- * \param port_id The destination port.
- * \param message The message to send.
- *
- * \return True if the message was posted.
- */
-DART_EXPORT bool Dart_PostCObject(Dart_Port port_id, Dart_CObject* message);
-
-/**
- * Posts a message on some port. The message will contain the integer 'message'.
- *
- * \param port_id The destination port.
- * \param message The message to send.
- *
- * \return True if the message was posted.
- */
-DART_EXPORT bool Dart_PostInteger(Dart_Port port_id, int64_t message);
-
-/**
- * A native message handler.
- *
- * This handler is associated with a native port by calling
- * Dart_NewNativePort.
- *
- * The message received is decoded into the message structure. The
- * lifetime of the message data is controlled by the caller. All the
- * data references from the message are allocated by the caller and
- * will be reclaimed when returning to it.
- */
-typedef void (*Dart_NativeMessageHandler)(Dart_Port dest_port_id,
- Dart_CObject* message);
-
-/**
- * Creates a new native port. When messages are received on this
- * native port, then they will be dispatched to the provided native
- * message handler.
- *
- * \param name The name of this port in debugging messages.
- * \param handler The C handler to run when messages arrive on the port.
- * \param handle_concurrently Is it okay to process requests on this
- * native port concurrently?
- *
- * \return If successful, returns the port id for the native port. In
- * case of error, returns ILLEGAL_PORT.
- */
-DART_EXPORT Dart_Port Dart_NewNativePort(const char* name,
- Dart_NativeMessageHandler handler,
- bool handle_concurrently);
-/* TODO(turnidge): Currently handle_concurrently is ignored. */
-
-/**
- * Closes the native port with the given id.
- *
- * The port must have been allocated by a call to Dart_NewNativePort.
- *
- * \param native_port_id The id of the native port to close.
- *
- * \return Returns true if the port was closed successfully.
- */
-DART_EXPORT bool Dart_CloseNativePort(Dart_Port native_port_id);
-
-/*
- * ==================
- * Verification Tools
- * ==================
- */
-
-/**
- * Forces all loaded classes and functions to be compiled eagerly in
- * the current isolate..
- *
- * TODO(turnidge): Document.
- */
-DART_EXPORT DART_WARN_UNUSED_RESULT Dart_Handle Dart_CompileAll(void);
-
-/**
- * Finalizes all classes.
- */
-DART_EXPORT DART_WARN_UNUSED_RESULT Dart_Handle Dart_FinalizeAllClasses(void);
-
-/* This function is intentionally undocumented.
- *
- * It should not be used outside internal tests.
- */
-DART_EXPORT void* Dart_ExecuteInternalCommand(const char* command, void* arg);
-
-#endif /* INCLUDE_DART_NATIVE_API_H_ */ /* NOLINT */
diff --git a/experimental/pedometer/src/health_connect/include/dart_tools_api.h b/experimental/pedometer/src/health_connect/include/dart_tools_api.h
deleted file mode 100644
index 90687f601..000000000
--- a/experimental/pedometer/src/health_connect/include/dart_tools_api.h
+++ /dev/null
@@ -1,620 +0,0 @@
-// Copyright (c) 2011, the Dart project authors. Please see the AUTHORS file
-// for details. All rights reserved. Use of this source code is governed by a
-// BSD-style license that can be found in the LICENSE file.
-
-#ifndef RUNTIME_INCLUDE_DART_TOOLS_API_H_
-#define RUNTIME_INCLUDE_DART_TOOLS_API_H_
-
-#include "dart_api.h" /* NOLINT */
-
-/** \mainpage Dart Tools Embedding API Reference
- *
- * This reference describes the Dart embedding API for tools. Tools include
- * a debugger, service protocol, and timeline.
- *
- * NOTE: The APIs described in this file are unstable and subject to change.
- *
- * This reference is generated from the header include/dart_tools_api.h.
- */
-
-/*
- * ========
- * Debugger
- * ========
- */
-
-/**
- * ILLEGAL_ISOLATE_ID is a number guaranteed never to be associated with a
- * valid isolate.
- */
-#define ILLEGAL_ISOLATE_ID ILLEGAL_PORT
-
-/**
- * ILLEGAL_ISOLATE_GROUP_ID is a number guaranteed never to be associated with a
- * valid isolate group.
- */
-#define ILLEGAL_ISOLATE_GROUP_ID 0
-
-/*
- * =======
- * Service
- * =======
- */
-
-/**
- * A service request callback function.
- *
- * These callbacks, registered by the embedder, are called when the VM receives
- * a service request it can't handle and the service request command name
- * matches one of the embedder registered handlers.
- *
- * The return value of the callback indicates whether the response
- * should be used as a regular result or an error result.
- * Specifically, if the callback returns true, a regular JSON-RPC
- * response is built in the following way:
- *
- * {
- * "jsonrpc": "2.0",
- * "result": <json_object>,
- * "id": <some sequence id>,
- * }
- *
- * If the callback returns false, a JSON-RPC error is built like this:
- *
- * {
- * "jsonrpc": "2.0",
- * "error": <json_object>,
- * "id": <some sequence id>,
- * }
- *
- * \param method The rpc method name.
- * \param param_keys Service requests can have key-value pair parameters. The
- * keys and values are flattened and stored in arrays.
- * \param param_values The values associated with the keys.
- * \param num_params The length of the param_keys and param_values arrays.
- * \param user_data The user_data pointer registered with this handler.
- * \param result A C string containing a valid JSON object. The returned
- * pointer will be freed by the VM by calling free.
- *
- * \return True if the result is a regular JSON-RPC response, false if the
- * result is a JSON-RPC error.
- */
-typedef bool (*Dart_ServiceRequestCallback)(const char* method,
- const char** param_keys,
- const char** param_values,
- intptr_t num_params,
- void* user_data,
- const char** json_object);
-
-/**
- * Register a Dart_ServiceRequestCallback to be called to handle
- * requests for the named rpc on a specific isolate. The callback will
- * be invoked with the current isolate set to the request target.
- *
- * \param method The name of the method that this callback is responsible for.
- * \param callback The callback to invoke.
- * \param user_data The user data passed to the callback.
- *
- * NOTE: If multiple callbacks with the same name are registered, only
- * the last callback registered will be remembered.
- */
-DART_EXPORT void Dart_RegisterIsolateServiceRequestCallback(
- const char* method,
- Dart_ServiceRequestCallback callback,
- void* user_data);
-
-/**
- * Register a Dart_ServiceRequestCallback to be called to handle
- * requests for the named rpc. The callback will be invoked without a
- * current isolate.
- *
- * \param method The name of the command that this callback is responsible for.
- * \param callback The callback to invoke.
- * \param user_data The user data passed to the callback.
- *
- * NOTE: If multiple callbacks with the same name are registered, only
- * the last callback registered will be remembered.
- */
-DART_EXPORT void Dart_RegisterRootServiceRequestCallback(
- const char* method,
- Dart_ServiceRequestCallback callback,
- void* user_data);
-
-/**
- * Embedder information which can be requested by the VM for internal or
- * reporting purposes.
- *
- * The pointers in this structure are not going to be cached or freed by the VM.
- */
-
- #define DART_EMBEDDER_INFORMATION_CURRENT_VERSION (0x00000001)
-
-typedef struct {
- int32_t version;
- const char* name; // [optional] The name of the embedder
- int64_t current_rss; // [optional] the current RSS of the embedder
- int64_t max_rss; // [optional] the maximum RSS of the embedder
-} Dart_EmbedderInformation;
-
-/**
- * Callback provided by the embedder that is used by the VM to request
- * information.
- *
- * \return Returns a pointer to a Dart_EmbedderInformation structure.
- * The embedder keeps the ownership of the structure and any field in it.
- * The embedder must ensure that the structure will remain valid until the
- * next invokation of the callback.
- */
-typedef void (*Dart_EmbedderInformationCallback)(
- Dart_EmbedderInformation* info);
-
-/**
- * Register a Dart_ServiceRequestCallback to be called to handle
- * requests for the named rpc. The callback will be invoked without a
- * current isolate.
- *
- * \param method The name of the command that this callback is responsible for.
- * \param callback The callback to invoke.
- * \param user_data The user data passed to the callback.
- *
- * NOTE: If multiple callbacks are registered, only the last callback registered
- * will be remembered.
- */
-DART_EXPORT void Dart_SetEmbedderInformationCallback(
- Dart_EmbedderInformationCallback callback);
-
-/**
- * Invoke a vm-service method and wait for its result.
- *
- * \param request_json The utf8-encoded json-rpc request.
- * \param request_json_length The length of the json-rpc request.
- *
- * \param response_json The returned utf8-encoded json response, must be
- * free()ed by caller.
- * \param response_json_length The length of the returned json response.
- * \param error An optional error, must be free()ed by caller.
- *
- * \return Whether the call was successfully performed.
- *
- * NOTE: This method does not need a current isolate and must not have the
- * vm-isolate being the current isolate. It must be called after
- * Dart_Initialize() and before Dart_Cleanup().
- */
-DART_EXPORT bool Dart_InvokeVMServiceMethod(uint8_t* request_json,
- intptr_t request_json_length,
- uint8_t** response_json,
- intptr_t* response_json_length,
- char** error);
-
-/*
- * ========
- * Event Streams
- * ========
- */
-
-/**
- * A callback invoked when the VM service gets a request to listen to
- * some stream.
- *
- * \return Returns true iff the embedder supports the named stream id.
- */
-typedef bool (*Dart_ServiceStreamListenCallback)(const char* stream_id);
-
-/**
- * A callback invoked when the VM service gets a request to cancel
- * some stream.
- */
-typedef void (*Dart_ServiceStreamCancelCallback)(const char* stream_id);
-
-/**
- * Adds VM service stream callbacks.
- *
- * \param listen_callback A function pointer to a listen callback function.
- * A listen callback function should not be already set when this function
- * is called. A NULL value removes the existing listen callback function
- * if any.
- *
- * \param cancel_callback A function pointer to a cancel callback function.
- * A cancel callback function should not be already set when this function
- * is called. A NULL value removes the existing cancel callback function
- * if any.
- *
- * \return Success if the callbacks were added. Otherwise, returns an
- * error handle.
- */
-DART_EXPORT char* Dart_SetServiceStreamCallbacks(
- Dart_ServiceStreamListenCallback listen_callback,
- Dart_ServiceStreamCancelCallback cancel_callback);
-
-/**
- * Sends a data event to clients of the VM Service.
- *
- * A data event is used to pass an array of bytes to subscribed VM
- * Service clients. For example, in the standalone embedder, this is
- * function used to provide WriteEvents on the Stdout and Stderr
- * streams.
- *
- * If the embedder passes in a stream id for which no client is
- * subscribed, then the event is ignored.
- *
- * \param stream_id The id of the stream on which to post the event.
- *
- * \param event_kind A string identifying what kind of event this is.
- * For example, 'WriteEvent'.
- *
- * \param bytes A pointer to an array of bytes.
- *
- * \param bytes_length The length of the byte array.
- *
- * \return NULL if the arguments are well formed. Otherwise, returns an
- * error string. The caller is responsible for freeing the error message.
- */
-DART_EXPORT char* Dart_ServiceSendDataEvent(const char* stream_id,
- const char* event_kind,
- const uint8_t* bytes,
- intptr_t bytes_length);
-
-/**
- * Usage statistics for a space/generation at a particular moment in time.
- *
- * \param used Amount of memory used, in bytes.
- *
- * \param capacity Memory capacity, in bytes.
- *
- * \param external External memory, in bytes.
- *
- * \param collections How many times the garbage collector has run in this
- * space.
- *
- * \param time Cumulative time spent collecting garbage in this space, in
- * seconds.
- *
- * \param avg_collection_period Average time between garbage collector running
- * in this space, in milliseconds.
- */
-typedef struct {
- intptr_t used;
- intptr_t capacity;
- intptr_t external;
- intptr_t collections;
- double time;
- double avg_collection_period;
-} Dart_GCStats;
-
-/**
- * A Garbage Collection event with memory usage statistics.
- *
- * \param type The event type. Static lifetime.
- *
- * \param reason The reason for the GC event. Static lifetime.
- *
- * \param new_space Data for New Space.
- *
- * \param old_space Data for Old Space.
- */
-typedef struct {
- const char* type;
- const char* reason;
-
- Dart_IsolateGroupId isolate_group_id;
-
- Dart_GCStats new_space;
- Dart_GCStats old_space;
-} Dart_GCEvent;
-
-/**
- * A callback invoked when the VM emits a GC event.
- *
- * \param event The GC event data. Pointer only valid for the duration of the
- * callback.
- */
-typedef void (*Dart_GCEventCallback)(Dart_GCEvent* event);
-
-/**
- * Sets the native GC event callback.
- *
- * \param callback A function pointer to an event handler callback function.
- * A NULL value removes the existing listen callback function if any.
- */
-DART_EXPORT void Dart_SetGCEventCallback(Dart_GCEventCallback callback);
-
-/*
- * ========
- * Reload support
- * ========
- *
- * These functions are used to implement reloading in the Dart VM.
- * This is an experimental feature, so embedders should be prepared
- * for these functions to change.
- */
-
-/**
- * A callback which determines whether the file at some url has been
- * modified since some time. If the file cannot be found, true should
- * be returned.
- */
-typedef bool (*Dart_FileModifiedCallback)(const char* url, int64_t since);
-
-DART_EXPORT char* Dart_SetFileModifiedCallback(
- Dart_FileModifiedCallback file_modified_callback);
-
-/**
- * Returns true if isolate is currently reloading.
- */
-DART_EXPORT bool Dart_IsReloading();
-
-/*
- * ========
- * Timeline
- * ========
- */
-
-/**
- * Enable tracking of specified timeline category. This is operational
- * only when systrace timeline functionality is turned on.
- *
- * \param categories A comma separated list of categories that need to
- * be enabled, the categories are
- * "all" : All categories
- * "API" - Execution of Dart C API functions
- * "Compiler" - Execution of Dart JIT compiler
- * "CompilerVerbose" - More detailed Execution of Dart JIT compiler
- * "Dart" - Execution of Dart code
- * "Debugger" - Execution of Dart debugger
- * "Embedder" - Execution of Dart embedder code
- * "GC" - Execution of Dart Garbage Collector
- * "Isolate" - Dart Isolate lifecycle execution
- * "VM" - Excution in Dart VM runtime code
- * "" - None
- *
- * When "all" is specified all the categories are enabled.
- * When a comma separated list of categories is specified, the categories
- * that are specified will be enabled and the rest will be disabled.
- * When "" is specified all the categories are disabled.
- * The category names are case sensitive.
- * eg: Dart_EnableTimelineCategory("all");
- * Dart_EnableTimelineCategory("GC,API,Isolate");
- * Dart_EnableTimelineCategory("GC,Debugger,Dart");
- *
- * \return True if the categories were successfully enabled, False otherwise.
- */
-DART_EXPORT bool Dart_SetEnabledTimelineCategory(const char* categories);
-
-/**
- * Returns a timestamp in microseconds. This timestamp is suitable for
- * passing into the timeline system, and uses the same monotonic clock
- * as dart:developer's Timeline.now.
- *
- * \return A timestamp that can be passed to the timeline system.
- */
-DART_EXPORT int64_t Dart_TimelineGetMicros();
-
-/**
- * Returns a raw timestamp in from the monotonic clock.
- *
- * \return A raw timestamp from the monotonic clock.
- */
-DART_EXPORT int64_t Dart_TimelineGetTicks();
-
-/**
- * Returns the frequency of the monotonic clock.
- *
- * \return The frequency of the monotonic clock.
- */
-DART_EXPORT int64_t Dart_TimelineGetTicksFrequency();
-
-typedef enum {
- Dart_Timeline_Event_Begin, // Phase = 'B'.
- Dart_Timeline_Event_End, // Phase = 'E'.
- Dart_Timeline_Event_Instant, // Phase = 'i'.
- Dart_Timeline_Event_Duration, // Phase = 'X'.
- Dart_Timeline_Event_Async_Begin, // Phase = 'b'.
- Dart_Timeline_Event_Async_End, // Phase = 'e'.
- Dart_Timeline_Event_Async_Instant, // Phase = 'n'.
- Dart_Timeline_Event_Counter, // Phase = 'C'.
- Dart_Timeline_Event_Flow_Begin, // Phase = 's'.
- Dart_Timeline_Event_Flow_Step, // Phase = 't'.
- Dart_Timeline_Event_Flow_End, // Phase = 'f'.
-} Dart_Timeline_Event_Type;
-
-/**
- * Add a timeline event to the embedder stream.
- *
- * \param label The name of the event. Its lifetime must extend at least until
- * Dart_Cleanup.
- * \param timestamp0 The first timestamp of the event.
- * \param timestamp1_or_async_id The second timestamp of the event or
- * the async id.
- * \param argument_count The number of argument names and values.
- * \param argument_names An array of names of the arguments. The lifetime of the
- * names must extend at least until Dart_Cleanup. The array may be reclaimed
- * when this call returns.
- * \param argument_values An array of values of the arguments. The values and
- * the array may be reclaimed when this call returns.
- */
-DART_EXPORT void Dart_TimelineEvent(const char* label,
- int64_t timestamp0,
- int64_t timestamp1_or_async_id,
- Dart_Timeline_Event_Type type,
- intptr_t argument_count,
- const char** argument_names,
- const char** argument_values);
-
-/**
- * Associates a name with the current thread. This name will be used to name
- * threads in the timeline. Can only be called after a call to Dart_Initialize.
- *
- * \param name The name of the thread.
- */
-DART_EXPORT void Dart_SetThreadName(const char* name);
-
-typedef struct {
- const char* name;
- const char* value;
-} Dart_TimelineRecorderEvent_Argument;
-
-#define DART_TIMELINE_RECORDER_CURRENT_VERSION (0x00000001)
-
-typedef struct {
- /* Set to DART_TIMELINE_RECORDER_CURRENT_VERSION */
- int32_t version;
-
- /* The event's type / phase. */
- Dart_Timeline_Event_Type type;
-
- /* The event's timestamp according to the same clock as
- * Dart_TimelineGetMicros. For a duration event, this is the beginning time.
- */
- int64_t timestamp0;
-
- /* For a duration event, this is the end time. For an async event, this is the
- * async id. */
- int64_t timestamp1_or_async_id;
-
- /* The current isolate of the event, as if by Dart_GetMainPortId, or
- * ILLEGAL_PORT if the event had no current isolate. */
- Dart_Port isolate;
-
- /* The current isolate group of the event, as if by
- * Dart_CurrentIsolateGroupId, or ILLEGAL_PORT if the event had no current
- * isolate group. */
- Dart_IsolateGroupId isolate_group;
-
- /* The name / label of the event. */
- const char* label;
-
- /* The stream / category of the event. */
- const char* stream;
-
- intptr_t argument_count;
- Dart_TimelineRecorderEvent_Argument* arguments;
-} Dart_TimelineRecorderEvent;
-
-/**
- * Callback provided by the embedder to handle the completion of timeline
- * events.
- *
- * \param event A timeline event that has just been completed. The VM keeps
- * ownership of the event and any field in it (i.e., the embedder should copy
- * any values it needs after the callback returns).
- */
-typedef void (*Dart_TimelineRecorderCallback)(
- Dart_TimelineRecorderEvent* event);
-
-/**
- * Register a `Dart_TimelineRecorderCallback` to be called as timeline events
- * are completed.
- *
- * The callback will be invoked without a current isolate.
- *
- * The callback will be invoked on the thread completing the event. Because
- * `Dart_TimelineEvent` may be called by any thread, the callback may be called
- * on any thread.
- *
- * The callback may be invoked at any time after `Dart_Initialize` is called and
- * before `Dart_Cleanup` returns.
- *
- * If multiple callbacks are registered, only the last callback registered
- * will be remembered. Providing a NULL callback will clear the registration
- * (i.e., a NULL callback produced a no-op instead of a crash).
- *
- * Setting a callback is insuffient to receive events through the callback. The
- * VM flag `timeline_recorder` must also be set to `callback`.
- */
-DART_EXPORT void Dart_SetTimelineRecorderCallback(
- Dart_TimelineRecorderCallback callback);
-
-/*
- * =======
- * Metrics
- * =======
- */
-
-/**
- * Return metrics gathered for the VM and individual isolates.
- *
- * NOTE: Non-heap metrics are not available in PRODUCT builds of Dart.
- * Calling the non-heap metric functions on a PRODUCT build might return invalid metrics.
- */
-DART_EXPORT int64_t Dart_VMIsolateCountMetric(); // Counter
-DART_EXPORT int64_t Dart_VMCurrentRSSMetric(); // Byte
-DART_EXPORT int64_t Dart_VMPeakRSSMetric(); // Byte
-DART_EXPORT int64_t
-Dart_IsolateGroupHeapOldUsedMetric(Dart_IsolateGroup group); // Byte
-DART_EXPORT int64_t
-Dart_IsolateGroupHeapOldUsedMaxMetric(Dart_IsolateGroup group); // Byte
-DART_EXPORT int64_t
-Dart_IsolateGroupHeapOldCapacityMetric(Dart_IsolateGroup group); // Byte
-DART_EXPORT int64_t
-Dart_IsolateGroupHeapOldCapacityMaxMetric(Dart_IsolateGroup group); // Byte
-DART_EXPORT int64_t
-Dart_IsolateGroupHeapOldExternalMetric(Dart_IsolateGroup group); // Byte
-DART_EXPORT int64_t
-Dart_IsolateGroupHeapNewUsedMetric(Dart_IsolateGroup group); // Byte
-DART_EXPORT int64_t
-Dart_IsolateGroupHeapNewUsedMaxMetric(Dart_IsolateGroup group); // Byte
-DART_EXPORT int64_t
-Dart_IsolateGroupHeapNewCapacityMetric(Dart_IsolateGroup group); // Byte
-DART_EXPORT int64_t
-Dart_IsolateGroupHeapNewCapacityMaxMetric(Dart_IsolateGroup group); // Byte
-DART_EXPORT int64_t
-Dart_IsolateGroupHeapNewExternalMetric(Dart_IsolateGroup group); // Byte
-DART_EXPORT int64_t
-Dart_IsolateGroupHeapGlobalUsedMetric(Dart_IsolateGroup group); // Byte
-DART_EXPORT int64_t
-Dart_IsolateGroupHeapGlobalUsedMaxMetric(Dart_IsolateGroup group); // Byte
-DART_EXPORT int64_t
-Dart_IsolateRunnableLatencyMetric(Dart_Isolate isolate); // Microsecond
-DART_EXPORT int64_t
-Dart_IsolateRunnableHeapSizeMetric(Dart_Isolate isolate); // Byte
-
-/*
- * ========
- * UserTags
- * ========
- */
-
-/*
- * Gets the current isolate's currently set UserTag instance.
- *
- * \return The currently set UserTag instance.
- */
-DART_EXPORT Dart_Handle Dart_GetCurrentUserTag();
-
-/*
- * Gets the current isolate's default UserTag instance.
- *
- * \return The default UserTag with label 'Default'
- */
-DART_EXPORT Dart_Handle Dart_GetDefaultUserTag();
-
-/*
- * Creates a new UserTag instance.
- *
- * \param label The name of the new UserTag.
- *
- * \return The newly created UserTag instance or an error handle.
- */
-DART_EXPORT Dart_Handle Dart_NewUserTag(const char* label);
-
-/*
- * Updates the current isolate's UserTag to a new value.
- *
- * \param user_tag The UserTag to be set as the current UserTag.
- *
- * \return The previously set UserTag instance or an error handle.
- */
-DART_EXPORT Dart_Handle Dart_SetCurrentUserTag(Dart_Handle user_tag);
-
-/*
- * Returns the label of a given UserTag instance.
- *
- * \param user_tag The UserTag from which the label will be retrieved.
- *
- * \return The UserTag's label. NULL if the user_tag is invalid. The caller is
- * responsible for freeing the returned label.
- */
-DART_EXPORT DART_WARN_UNUSED_RESULT char* Dart_GetUserTagLabel(
- Dart_Handle user_tag);
-
-#endif // RUNTIME_INCLUDE_DART_TOOLS_API_H_
diff --git a/experimental/pedometer/src/health_connect/include/dart_version.h b/experimental/pedometer/src/health_connect/include/dart_version.h
deleted file mode 100644
index b3b492439..000000000
--- a/experimental/pedometer/src/health_connect/include/dart_version.h
+++ /dev/null
@@ -1,16 +0,0 @@
-/*
- * Copyright (c) 2020, the Dart project authors. Please see the AUTHORS file
- * for details. All rights reserved. Use of this source code is governed by a
- * BSD-style license that can be found in the LICENSE file.
- */
-
-#ifndef RUNTIME_INCLUDE_DART_VERSION_H_
-#define RUNTIME_INCLUDE_DART_VERSION_H_
-
-// On breaking changes the major version is increased.
-// On backwards compatible changes the minor version is increased.
-// The versioning covers the symbols exposed in dart_api_dl.h
-#define DART_API_DL_MAJOR_VERSION 2
-#define DART_API_DL_MINOR_VERSION 0
-
-#endif /* RUNTIME_INCLUDE_DART_VERSION_H_ */ /* NOLINT */
diff --git a/experimental/pedometer/src/health_connect/include/internal/dart_api_dl_impl.h b/experimental/pedometer/src/health_connect/include/internal/dart_api_dl_impl.h
deleted file mode 100644
index e4a568931..000000000
--- a/experimental/pedometer/src/health_connect/include/internal/dart_api_dl_impl.h
+++ /dev/null
@@ -1,21 +0,0 @@
-/*
- * Copyright (c) 2020, the Dart project authors. Please see the AUTHORS file
- * for details. All rights reserved. Use of this source code is governed by a
- * BSD-style license that can be found in the LICENSE file.
- */
-
-#ifndef RUNTIME_INCLUDE_INTERNAL_DART_API_DL_IMPL_H_
-#define RUNTIME_INCLUDE_INTERNAL_DART_API_DL_IMPL_H_
-
-typedef struct {
- const char* name;
- void (*function)(void);
-} DartApiEntry;
-
-typedef struct {
- const int major;
- const int minor;
- const DartApiEntry* const functions;
-} DartApi;
-
-#endif /* RUNTIME_INCLUDE_INTERNAL_DART_API_DL_IMPL_H_ */ /* NOLINT */