IDLizer

Description

This folder contains collection of tools for analyzing and transformation of .d.ts files, with aim of exposing ArkUI interfaces to more languages and runtimes.

Tools available

Peer generator

Prerequisites:

Generating libace interface files:

Given interface definitions it will produce for libace

• For libace interface
  • arkoala_api.h header
  • api discovery code
  • component modifiers
  • etc

Generating high level language peer files:

Given interface definitions it will produce for Arkoala

• For high language bindings (arkoala)
  • C++ glue code
  • high level language peer classes (TS, ArkTS, Java, etc)
  • etc

To test for full sdk

The output is in

directory

To test with a simple subset sdk

The output is in

directory

.d.ts linter

Tool checking that given folder (ArkUI interface declarations downloaded by Arkoala build by default) only contains reasonable set of TypeScript features allowed for usage in public interfaces.

To run

Results are in

if

--output-dir

parameter specified, otherwise printed to stdout. If there are no unsuppressed errors - exit code is 1, otherwise it is 0.

Linter support whitelist files in JSON:

can be passed with

.

IDL generator

Tool producing set of WebIDL-compatible interface definitions from .d.ts interface definitions. Still in progress, may produce incorrect IDL.

Results are in

folder.

C headers generator

Tool producing set of C interface definitions from .d.ts interface definitions. Still in progress, will produce incorrect C now.

Results are in

.

Typescript declaration files generator

Tool producing set of typescript declaration files from .idl interface definitions.

By default, results are in

.

Tests

Use the

environment variable to set a predefined seed for the random generator used in tests. Set the

IDLIZE_SEED

environment variable to

RANDOM

to use a random seed.

Configure and run the subset fuzzing tests:

To test a specific test or method in fuzzing tests use

and

--test-method

options in the

check:subset:fuzz

task: