duktape-ohos

Проект duktape-ohos

• Проект: duktape-ohos.

• Серия: openharmony, серия сторонних компонентов для адаптации.

• Функция: используется для Duktape, встроенного JavaScript-движка.

• Состояние переноса проекта: основные функции реализованы.

• Различия в вызовах: отсутствуют.

• Версия разработки: SDK6, DevEco Studio2.2 beta1.

• Базовая версия: Release 1.3.0.

Демонстрация эффекта

Демонстрационный эффект представлен на изображении demo.gif.

Инструкция по установке

1. В файле build.gradle в корневом каталоге проекта:

// Добавление maven-репозитория
repositories {
    maven {
        url 'https://s01.oss.sonatype.org/content/repositories/release/'
    }
}

2. В файле build.gradle модуля entry:

// Добавление зависимостей
dependencies {
   implementation 'com.gitee.chinasoft_ohos:duktape:1.0.0'
   implementation 'com.gitee.chinasoft_ohos:quickjs:1.0.0'
}

Проект можно запустить непосредственно в SDK6 и DevEco Studio 2.2 beta1. Если проект не запускается, удалите файлы .gradle, .idea, build, gradle и build.gradle и создайте новый проект с учётом вашей версии. Затем скопируйте файлы из нового проекта в корневой каталог.

Использование

Использование:

Duktape duktape = Duktape.create();
try {
  HiLog.info(TAG, duktape.evaluate("'hello world'.toUpperCase();").toString());
} finally {
  duktape.close();
}

Текущий интерфейс с JavaScript поддерживает следующие типы Java:

— boolean и Boolean;

— int и Integer — только для вызовов без возврата значения из Java в JavaScript;

— double и Double;

— String;

— void — как возвращаемое значение.

Также поддерживается тип Object, но фактическое значение должно быть одним из перечисленных типов или null.

Вызов Java из JavaScript

Для использования объекта Java в качестве глобальной переменной JavaScript выполните следующие шаги:

Пример

Предположим, мы хотим предоставить доступ к функциям ByteString из okio в JavaScript. Сначала определим интерфейс Java для методов, которые мы хотим вызвать из JavaScript:

interface Utf8 {
  String fromHex(String hex);
}

Затем реализуем интерфейс в коде Java (мы оставляем сложную работу okio):

Utf8 utf8 = new Utf8() {
  @Override 
  public String fromHex(String hex) {
    return okio.ByteString.decodeHex(hex).utf8();
  }
};

Теперь мы можем установить объект как глобальный объект JavaScript, чтобы он был доступен в коде JavaScript:

// Attach our interface to a JavaScript object called Utf8.
duktape.set("Utf8", Utf8.class, utf8);

String greeting = (String) duktape.evaluate(""
    // Here we have a hex encoded string.
    + "var hexEnc = 'EC9588EB8595ED9598EC84B8EC9A9421';\n"
    // Call out to Java to decode it!
    + "var message = Utf8.fromHex(hexEnc);\n"
    + "message;");

HiLog.info(TAG, greeting);

Вызов JavaScript из Java

Вы можете присоединить интерфейс Java к глобальному объекту JavaScript и вызывать функции JavaScript напрямую из кода Java! Параметры функций и возвращаемые значения поддерживают те же типы Java.

Пример

Представьте себе мир без okio ByteString. К счастью, существует Duktape, который позволяет нам преобразовывать шестнадцатеричные строки в формат UTF-8! Мы можем легко создать прокси, который позволит нам использовать его непосредственно из кода Java. Сначала определите интерфейс Java, который объявляет метод JavaScript, который вы хотите вызвать:

interface Utf8 {
  String fromHex(String hex);
}

Далее мы определяем глобальный объект JavaScript в Duktape:

// Note that Duktape.dec returns a Buffer, we must convert it to a String return value.
duktape.evaluate(""
    + "var Utf8 = {\n"
    + "  fromHex: function(v) { return String(Duktape.dec('hex', v)); }\n"
    + "};");

Теперь вы можете подключить наш интерфейс к глобальному коду JavaScript, чтобы сделать его доступным в коде Java:

// Connect our interface to a JavaScript object called Utf8.
Utf8 utf8 = duktape.get("Utf8", Utf8.class);

// Call into the JavaScript object to decode a string.
String greeting = utf8.fromHex("EC9588EB8595ED9598EC84B8EC9A9421");
HiLog.info(TAG, greeting);

Тестирование

CodeCheck — тестирование кода без исключений.

CloudTest — тестирование кода без исключений.

Проверка на вирусы пройдена.

Текущая версия demo функционально не отличается от исходного компонента.

Версия

• 1.0.0

Авторские права и лицензии

Copyright 2015 Square, Inc.

Licensed under the Apache License, Version 2.0 (the "License");
you may not use this file except in compliance with the License.
You may obtain a copy of the License at

   http://www.apache.org/licenses/LICENSE-2.0

Unless required by applicable law or agreed to in writing, software
distributed under the License is distributed on an "AS IS" BASIS,
WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
See the License for the specific language governing permissions and
limitations under the License.

Note: The included C code from Duktape is licensed under MIT.