Merge pull request #46 from ZennoLab/dev

docs: add ZennoProxyChecker Russian user documentation

Author: djaga-ru

docs/Android/App.mdx

@@ -0,0 +1,97 @@
+---
+sidebar_position: 4
+title: Действия с приложением
+description: Функции для работы в виртуальной машине
+---
+:::info **Пожалуйста, ознакомьтесь с [*Правилами использования материалов на данном ресурсе*](../Disclaimer).**
+:::
+_______________________________________________
+Сейчас мы рассмотрим доступные функции для работы непосредственно в виртуальной машине. Например, установка приложений, запуск, остановка, выполнение консольной команды (ADB Shell) и др.  
+
+
+## Как добавить в проект?  
+***Нажимаем ПКМ → Добавить действие → Android → Действия с приложением***  
+
+![Добавить в проект](./assets/App/App_pic1.png)  
+_______________________________________________   
+## Доступные действия.  
+### Установка приложения.  
+![Установка приложения](./assets/App/App_pic2.png)  
+Данное действие позволяет установить приложение из APK файла. Поддерживаемые форматы: ***.xapk, .apkm, .apks***
+_______________________________________________  
+### Удаление приложения.  
+![Удаление приложения](./assets/App/App_pic3.png)  
+Этот экшен удаляет установленное приложение по его имени, которое можно узнать с помощью инструмента  
+**Установленные приложения**.  
+_______________________________________________ 
+### Открыть приложение.  
+![Открыть приложение](./assets/App/App_pic4.png)  
+Позволяет запустить ранее установленное приложение.  
+_______________________________________________  
+### Закрыть приложение.  
+![Закрыть приложение](./assets/App/App_pic5.png)  
+Закрывает приложение (аналог команды `adb shell am force-stop com.package`). 
+_______________________________________________ 
+### Очистка приложения.  
+![Очистка приложения](./assets/App/App_pic6.png)   
+Это действие нужно, чтобы стереть все данные пользователя.  
+Поставив галочку на ***Очистить только кэш***, вы удалите только его, оставив все остальное. 
+_______________________________________________ 
+### Сохранить данные приложения.  
+![Сохранить данные приложения](./assets/App/App_pic7.png)  
+Данный экшен сохраняет все данные приложения.  
+#### Доступные параметры:    
+- *Имя приложения*. Можно узнать с помощью инструмента **Установленные приложения**.  
+- *Путь к файлу с архивом*. Тут необходимо указать путь, куда будут сохранены заархивированные данные приложения (формат архива - ***tar.gz***).  
+:::tip **Лучше так.**
+Перед сохранением данных приложение лучше закрыть с помощью экшена Эмуляция клавиатуры с таким текстом внутри: `{AndroidKeys.HOME}`. Это эмуляция нажатия клавиши HOME.
+:::  
+
+#### Зачем закрывать приложение перед сохранением?  
+Если в момент сохранения данных приложение будет открыто, то есть вероятность того, что часть из них будет в оперативной памяти, а не в файлах. Тогда эти данные не будут сохранены. Также не стоит для этих целей закрывать приложение с помощью экшена **Закрыть приложение**, так как он убивает процесс, что может привести к потере данных.  
+### Восстановить данные приложения.  
+![Восстановить данные приложения](./assets/App/App_pic8.png)  
+С помощью данной функции вы можете загрузить данные приложения, которые были сохранены с помощью прошлого действия (***Сохранить данные приложения***).  
+#### Доступные параметры:  
+- *Имя приложения*. Можно узнать с помощью инструмента **Установленные приложения**.  
+- *Путь к файлу с архивом*. Тут необходимо указать путь к архиву с данным от приложения.  
+:::warning **Внимание.**
+При восстановлении данных приложение должно быть установлено в системе, но не запущено!
+::: 
+ 
+### Получить apk приложения.  
+![Получить apk приложения](./assets/App/App_pic9.png)  
+Этот экшен позволяет получить установочный файл приложения в формате ***.apk*** или ***.apks***  
+В дальнейшем приложение можно будет установить с помощью экшена **Установка apk**.  
+_______________________________________________   
+### Получить куки из приложения.  
+![Получить куки из приложения](./assets/App/App_pic10.png)   
+Данное действие получает куки из приложений с Web содержимым, которые возвращаются в формате json.  
+Затем эти данные можно прочесть с помощью экшена **Обработка JSON и XML**  
+_______________________________________________ 
+### Получить уведомления.  
+![Получить уведомления](./assets/App/App_pic11.png)   
+Экшен получает уведомления от приложений из шторки (верхней системной панели) в формате json.  
+Затем эти данные можно прочесть с помощью экшена **Обработка JSON и XML**  
+_______________________________________________ 
+### Очистить уведомления.  
+![Очистить уведомления](./assets/App/App_pic15.png)  
+Эта функция убирает все накопившиеся уведомления из верхней шторки.  
+_______________________________________________   
+### Имя активного приложения.  
+![Имя активного приложения](./assets/App/App_pic12.png)  
+С помощью этого действия мы можем получить название приложения, которое активно и находится на переднем плане устройства.  
+_______________________________________________   
+### Получить список приложений.  
+![Получить список приложений](./assets/App/App_pic13.png)  
+Экшен позволяет получить названия всех установленных приложений и сохранить их в список.  
+#### Фильтр получаемых приложений:  
+- *Все*. Все приложения установленные на устройстве.  
+- *Системные*. Предустановленные приложения, которые обычно нельзя удалить, а можно только скрыть.  
+- *Пользовательские*. Приложения, которые были установлены вами в процессе работы.  
+_______________________________________________ 
+### Проверка, что приложение уже установлено.  
+![Проверка, что приложение уже установлено](./assets/App/App_pic14.png)  
+Данная функция проверяет наличие приложения на устройстве. Его отсутствие будет трактоваться как ошибка, и выход пойдет по красной ветке.
+
+   

docs/Android/Files.mdx

@@ -0,0 +1,32 @@
+---
+sidebar_position: 5
+title: Работа с файлами
+description: Отправка файлов на устройство и обратно.
+---  
+:::info **Пожалуйста, ознакомьтесь с [*Правилами использования материалов на данном ресурсе*](../Disclaimer).**
+:::
+_______________________________________________
+Данный экшен позволяет отправлять файлы с компьютера на устройство и наоборот.  
+_______________________________________________
+## Как добавить в проект?  
+***Нажимаем ПКМ → Добавить действие → Android → Файлы***  
+
+![Добавить в проект](./assets/Files/Files_pic1.png)  
+_______________________________________________ 
+### Отправка файла.  
+![Отправка файла](./assets/Files/Files_pic2.png)   
+Эту функция нужна, чтобы скопировать файл с компьютера на устройство.  
+#### Доступные параметры:  
+- *Путь к файлу*. Полный путь к файлу на компьютере.  
+- *Новый путь*. Место, куда будет сохранен скопированный файл.  
+Можно указать полный путь, задав название файла: ***/sdcard/Pictures/pic.png*** или же указать  
+только папку: ***/sdcard/Pictures/***. Во втором сценарии файл будет скопирован с имеющимся названием.   
+Медиафайлы будут автоматически обновлены в галерее после отправки.  
+:::info **Обратите внимание.**
+Для отправки файлов в папки, которые находятся в режиме **Только для чтения**, такие как **/system**, необходимо предварительно выполнить команду `mount -o remount,rw /system` с помощью экшена **Консольная команда (ADB Shell)**. 
+::: 
+
+### Получение файла.  
+![Получение файла](./assets/Files/Files_pic3.png)  
+
+С помощью данного действия можно наоборот скопировать файл уже с устройства на компьютер. Параметры идентичны тем, что описаны в прошлой функции, без каких-либо нюансов.

docs/Android/Keyboard_and_Swipe.mdx

@@ -0,0 +1,79 @@
+---
+sidebar_position: 6
+title: Эмуляция клавиатуры и Swipe. 
+description: Нажатие на клавиатуру и прокручивание страницы.
+---
+:::info **Пожалуйста, ознакомьтесь с [*Правилами использования материалов на данном ресурсе*](../Disclaimer).**
+:::
+_______________________________________________
+## Эмуляция клавиатуры в ZD.  
+![Добавить в проект](./assets/Keyboard_and_Swipe/Keyboard_and_Swipe_pic1.png)  
+Экшен позволяет эмулировать ввод данных в текстовые поля с помощью клавиатуры. А также нажатие системных кнопок, таких как кнопка **«Домой»**, **«Все запущенные приложения»**, **«Назад»**,  питание, звук и прочие.  
+_______________________________________________
+### Как добавить в проект?  
+***Нажимаем ПКМ → Добавить действие → Android → Эмуляция клавиатуры***  
+
+![Добавить в проект](./assets/Keyboard_and_Swipe/Keyboard_and_Swipe_pic2.png)
+_______________________________________________ 
+### Что можно указать в поле «Текст»?  
+![Добавить в проект](./assets/Keyboard_and_Swipe/Keyboard_and_Swipe_pic3.png) 
+
+В текстовое поле экшена можно ввести простой текст, переменные или макросы специальных клавиш: `{AndroidKeys.BACK}`, `{AndroidKeys.HOME}`, `{AndroidKeys.CLEAR}`. Последние эмулируют некоторые системные (и не только) кнопки Android.   
+
+### Какие есть макросы клавиш?  
+- `{AndroidKeys.ENTER}`. Новая строка. Отправка формы на сайтах. Подтверждение действий в приложениях.    
+- `{AndroidKeys.APP_SWITCH}`. Отображение недавно запущенных приложений.  
+- `{AndroidKeys.BACK}`. Возврат назад.  
+- `{AndroidKeys.CLEAR}`. Очистить поле ввода.  
+- `{AndroidKeys.HOME}`. Возврат на рабочий стол.  
+- `{AndroidKeys.COPY}`. Копирование выделенного текста в буфер обмена.  
+- `{AndroidKeys.POWER}`. Эмуляция нажатия кнопки питания.  
+- `{AndroidKeys.VOLUME_DOWN/UP}`. Уменьшение или увелечение громкости.  
+- `{AndroidKeys.CAMERA}`. Активация камеры.  
+- `{AndroidKeys.DEL}`. Удаление одного символа слева от курсора.  
+
+Это только часть доступных команд, остальные можно найти [**Здесь**](https://developer.android.com/reference/android/view/KeyEvent).  
+
+<details>
+<summary>**Помимо имени для вызова кнопки можно также использовать ее цифровой код.  
+Найти его можно по ссылке выше, нажав на название макроса.**</summary>
+<!--All you need is a blank line-->
+
+   ![Цифровой код](./assets/Keyboard_and_Swipe/Keyboard_and_Swipe_pic4.png)
+</details>
+>  
+ 
+### Задержка.  
+![Добавить в проект](./assets/Keyboard_and_Swipe/Keyboard_and_Swipe_pic5.png)  
+Данный параметр позволяет выставить паузу между выводом символов.  
+
+![Добавить в проект](./assets/Keyboard_and_Swipe/Keyboard_and_Swipe_pic6.png)  
+Однако если убрать чекбокс возле слова “Задержка”, то это ее отключит, и текст будет выводиться моментально.  
+:::warning **Внимательно.**
+При отключении задержки перестают работать Android макросы. Они будут напечатаны как обычный текст.
+::: 
+
+## Эмуляция swipe в ZD.   
+С помощью этого действия можно совершить свайп. Он применяется при вертикальной прокрутке страниц в браузере и других приложениях; при перемещении по горизонтальному меню; при движении по экрану по диагонали.   
+### Как добавить в проект?  
+*Нажимаем ПКМ → Добавить действие → Android → Эмуляция swipe*  
+
+![Добавить в проект](./assets/Keyboard_and_Swipe/Keyboard_and_Swipe_pic8.png) 
+_______________________________________________ 
+### Доступные параметры.  
+![Добавить в проект](./assets/Keyboard_and_Swipe/Keyboard_and_Swipe_pic7.png) 
+#### Координаты.  
+Указываем координаты начальной ***(X от и Y от)*** и конечной ***(X до и Y до)*** точек свайпа.  
+Где ***X*** – координата по горизонтали, а ***Y*** – по вертикали.  
+#### Long Tap And Swipe.  
+Если поставить здесь галочку, то перед свайпом будет эмулировано долгое нажатие.  
+#### Продолжительность (мс).  
+Эта настройка регулирует скорость в милисекундах, с которой должен быть осуществлён свайп.  
+#### Изогнутый.  
+Позволяет выполнить более реалистичное движение пальца не по прямой, а кривой линии.
+
+
+
+
+
+

docs/Android/Text_Checker.mdx

@@ -0,0 +1,8 @@
+---
+sidebar_position: 8
+title: Проверка текста. 
+description: Проверка наличия текста на экране.
+---
+:::info **Пожалуйста, ознакомьтесь с [*Правилами использования материалов на данном ресурсе*](../Disclaimer).**
+:::
+_______________________________________________

docs/Android/Touch_Emulation.mdx

@@ -0,0 +1,8 @@
+---
+sidebar_position: 7
+title: Эмуляция Touch. 
+description: Эмулировать Touch-событие в пределах указанных координат.
+---
+:::info **Пожалуйста, ознакомьтесь с [*Правилами использования материалов на данном ресурсе*](../Disclaimer).**
+:::
+_______________________________________________