From 6d0a29d77df6d25c5c042d3080467fa9ff8add05 Mon Sep 17 00:00:00 2001
From: Evgeny <zobnin@gmail.com>
Date: Thu, 29 Jul 2021 14:32:46 +0300
Subject: [PATCH] add addWidget and removeWidget functions

---
 README_ru.md                 | 21 +++++++++++++--------
 actions_test.lua             |  2 +-
 widget_add_remove_sample.lua | 11 +++++++++++
 3 files changed, 25 insertions(+), 9 deletions(-)
 create mode 100644 widget_add_remove_sample.lua

diff --git a/README_ru.md b/README_ru.md
index e3acf88..a7c4c23 100644
--- a/README_ru.md
+++ b/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)`. В нем следует обрабатывать результат.
 
 # Функции обработки данных
 
diff --git a/actions_test.lua b/actions_test.lua
index bfd6137..783c135 100644
--- a/actions_test.lua
+++ b/actions_test.lua
@@ -3,5 +3,5 @@ function onResume()
 end
 
 function onClick()
-    system:aioAction("apps_menu")
+    aio:doAction("apps_menu")
 end
diff --git a/widget_add_remove_sample.lua b/widget_add_remove_sample.lua
new file mode 100644
index 0000000..be24116
--- /dev/null
+++ b/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