add addWidget and removeWidget functions

README_ru.md

@@ -6,12 +6,6 @@
 
 Для большинства сетевых скриптов (загрузка и показ значений) следует использовать `onAlarm`. Использование других функций может привести к блокировке вашего IP.
 
-# Сетевые функции
-
-* `net:getText(url)` - функция для получения текстовых данных по сети (JSON, XML, plain text).
-
-Функция не возвращает никакого значения, а вместо этого вызывает колбек `onNetworkResult(string)`. В нем следует обрабатывать результат.
-
 # Функции показа данных
 
 * `ui:showText(string)` - выводит в виджет обычный текст; повторный вызов стирает предыдущий текст;
@@ -27,10 +21,21 @@
 
 * `system:openApp(string)` - открывает приложение, имя пакета которого указано в аргументе;
 * `system:openBrowser(string)` - открывает указанный URL в браузере или в приложении, умеющем обрабатывать данный тип URL;
-* `system:getLocation()` - возвращает местоположение в таблице с двумя значениями (запрос местоположения НЕ выполняется, используется значение, сохраненное системой ранее);
 * `system:exec(string)` - выполняет shell-команду;
 * `system:su(string)` - выполняет shell-команду от имени root;
-* `system:aioAction(string)` - позволяет выполнить действие AIO ([подробнее](https://aiolauncher.app/api.html)).
+* `system:getLocation()` - возвращает местоположение в таблице с двумя значениями (запрос местоположения НЕ выполняется, используется значение, сохраненное системой ранее).
+
+# Функции управления лаунчером
+
+* `aio:doAction(string)` - выполняет действие AIO ([подробнее](https://aiolauncher.app/api.html));
+* `aio:addWidget(string)` - добавляет на экран встроенный виджет или виджет-скрипт;
+* `aio:removeWidget(string` - удаляет с экрана встроенный виджет или виджет-скрипт (внимание: доп. виджеты тоже будут удалены);
+
+# Сетевые функции
+
+* `net:getText(url)` - функция для получения текстовых данных по сети (JSON, XML, plain text).
+
+Функция не возвращает никакого значения, а вместо этого вызывает колбек `onNetworkResult(string)`. В нем следует обрабатывать результат.
 
 # Функции обработки данных
 

actions_test.lua

@@ -3,5 +3,5 @@ function onResume()
 end
 
 function onClick()
-    system:aioAction("apps_menu")
+    aio:doAction("apps_menu")
 end

widget_add_remove_sample.lua

@@ -0,0 +1,11 @@
+function onResume()
+    ui:showButtons({ "Add clock widget", "Remove clock widget" })
+end
+
+function onClick(idx)
+    if idx == 1 then
+        aio:addWidget("clock")
+    else
+        aio:removeWidget("clock")
+    end
+end