DroidScript
DroidScript
учимся и разрабатываем

Пакет поставки

14.05.2017

На этой странице рассматриваются недокументированные возможности DroidScript и входящие в пакет поставки файлы.

DroidScript имеет две скрытые по умолчанию возможности - доступ к beta-версии и SDK для создания шаблонов Java-плагинов. Cокрытие этих возможностей сделано специально для того, чтобы не вводить в заблуждение начинающих разработчиков и посетителей общего форума. Дело в том, что существует несколько ветвей официального форума:

  • для премиум-пользователей (быстрый ответ на интересующией вопросы, глубокое обсуждение деталей работы DroidScript, работа с плагинами и т.п.)
  • для beta-тестировщиков (обсуждение вопросов, касающихся работоспособности и отладки новой функциональности DS, внесение предложений и т.п.)
  • общий (доступный для всех)

Для пользователей DroidScript изначально доступен лишь общий форум, на котором обсуждение возможностей beta-версии привело бы к постоянным вопросам, а почему показанное не работает в обычное версии? Если вам интересно протестировать новые возможности DroidScript, то можно стать beta-тестером, направив письмо с запросом разработчикам. А можно просто включить beta-версию, записав в корневую папку DroidScript пустой файл с названием _beta_.

Вопросы разработки Java-плагинов также выходят за рамки обсуждения на общем форуме, но вы можете включить доступ к генератору шаблонов Java-плагинов, записав в корневую директорию DroidScript пустой файл _sdk_. После этого в меню "..." DroidScript появится пункт SDK.

DroidScript поставляется с частично открытым исходным кодом, который можно просматривать и использовать в образовательных целях.Об этой возможности открыто не говорят, но в исходном коде разработчики дают комментариий, поясняющий код тем, кому интересно заглянуть поглубже в возможности DroidScript.

Apk-файлы на самом деле являются архивами, содержание которых хранится в исходном виде и его можно просмотреть. Для этого достаточно переименовать расширение apk на zip и распаковать его.

Файлы IDE

В корневой папке DroidScript находится скрытая папка .edit, в которой расположены файлы удалённой браузерной среды разработки WiFi IDE и вспомогательные ресурсы, необходимые для её работы. Не все файловые менеджеры Android позволяют открывать файлы в скрытых папках. Если вы столкнулись с такой ситуацией, то попробуйте открыть файлы в другом файловом менеджере или редакторе.

В директории IDE находятся следующие файлы:

app.js - интерфейсный файл API DroidScript
index.html
- интерфейсный файл WiFi-редактора
ide.min.js - функциональный модуль WiFi-редактора
ide.min.css - файл стилей WiFi-редактора

Разработчики не рекомендуют вносить изменения в файлы IDE, поскольку малейшая опечатка может привести к её неработоспособности. К тому же, эти изменения пропадут после обновления версии IDE, что может случиться при обновлении версии DroidScript. Для расширения возможностей IDE рекомендуется встраивать их в систему вкладок. В этом случае код расширения сохраняется в пользовательской папке и не будет перезаписан при обновлении IDE.

Файл app.js интересен тем, что в нём объявлены практически все методы объектов API DroidScript. Этот файл можно использовать в качестве справочной системы.

В папке IDE также расположены папки:

androidscript-ace
- вспомогательные скрипты
browse - файлы поддержки работы IDE
bootstrap - фреймворк Bootstrap
docs - документация, доступная на вкладке Docs в IDE
font-awesome - фреймворк Font-Awesome
jquery - фреймворк jQuery
polyfill - фреймворк поддержки ассинхронной работы
resources - ресурсы
tabdrop - вспомогатьельная папка Bootstrap

WiFi IDE является дополнением DroidScript, поэтому здесь можно увидеть продублированную информацию из приватной папки DroidScript. По этой причине для уверенности в использовании реального исходного кода его желательно брать из приватной папки DroidScript, а не из IDE.

Приватная часть

В приватной папке /android_asset содержатся файлы DroidScript. Получить доступ к данной папке через проводники файлов, скорее всего, не получится, но извлечь её содержимое можно.

Распространять код приватной части не разрешается, но можно изучать его и использовать лично для себя, например, можно улучшить модуль работы с вкладками.

В приватной папке содержатся файлы:

app.js - интерфейсный файл API DroidScript
asset.js - проводник ресурсов
bws.js - браузерный сервер IDE
cp.js - поддержка плагинов
dgl.js - диалог вввода текста
DroidScript.js - файл DroidScript
gl.js - GL-расширение
nxt.js - вспомогательный модуль для работы с NXT
sql.js - модуль для работы с SQLite
sw.js - модуль для работы с умными часами
tabs.js - модуль для работы с вкладками
util.js - утилиты
ws.js - модуль для работы с web-сокетами

Также интерес могут вызвать папки:

Html - с примером создания простого Html app
Img - графика для примеров
Samples - файлы примеров из справки
sdcard - пример работы с web-сервером
sdk - файлы шаблонов для создания Java-плагинов
webkit - вспомогательные файлы

Определённый интерес представляет папка с примерами. Некоторые примеры в текущей версии DroidScript могут посмотреть только премиум-пользователи (те, кто оплатил платную подписку). Но при помощи небольшого лайвхака - копирования файлов примеров из приватной папки в общедоступную, эти примеры может посмотреть и обычный пользователь.

Закрытая часть

Закрытый (нативный) код DroidScript написан на Java и посмотреть его штатными средствами невозможно, да и не нужно. При желании вы можете найти в сети описание и примеры построения JavaScript-Java мостов, на чём основана работа DroidScript..

© 2016-2024 
actech