AutoIt

Разработка плагинов с использованием AutoIt3.

Следуйте инструкции

1. Создайте папку с названием в виде имени будущего плагина

Далее можете продолжить следовать инструкции или скачать готовый пример и на его основе создать свой плагин. Чтобы установить данный плагин, не распаковывая, измените имя файла на SimpleAuto3.srp (не забудьте про расширение) и перетащите файл на список установленных плагинов.

431B

main.zip

archive

Пример готового плагина (не установщик)

2. В данной папке (далее в гайде просто main_folder)

{main_folder} = main_folder. Все переменные в гайде обозначаются в фигурных скобках.

3. Создайте следующую структуру файлов:

{main_folder}\main.manifest
{main_folder}\main.au3

4. В файл main.manifest (текстовый файл манифеста плагина с надстройками) вставьте следующий текст:

chat_action_type = 1
message_type = 0
arguments_count = 0
plugin_type = 1

Описание

chat_action_type - тип действия, которое будет написано в чате во время работы файла

Значения

• 0 - ничего не писать

• 1 - "Бот набирает сообщение..".

message_type - тип возвращаемого сообщения в Telegram бота

Значения

• 0 - Текстовое сообщение

• 1 - Текстовое сообщение с поддержкой HTML форматирования

• 2 - Ничего не возвращать

Значения для данного параметра не применяются к плагинам на AutoIt!

arguments_count - количество обязательных принимаемых аргументов плагина от пользователя

Значения

• От 0 до 4

Значения для данного параметра не применяются к плагинам на AutoIt!

plugin_type - тип плагина (указывается опционально). Единственное значение - 1

5. Основной код можно написать в файле main.au3 в любом текстовом редакторе или редакторе кода. Рекомендуется Visual Studio Code с плагином AutoIt.

6. Вставьте в файл main.ps1 следующий код (базовый пример):

#app {plugin_name}, Version="{plugin_version}", Author={author}, Command={call_command}

run('cmd')

Данный пример кода откроет Командную строку.

7. Заполните данные (всё без пробелов):

• {plugin_name} - название плагина, такое же как для {main_folder}

• {plugin_version} - версия в формате x.x.x.x, где x - число (например: 1.0.0.4)

• {author} - автор плагина

• {call_command} - команда для вызова плагина (обязательно начинается с /), например: /hello

Должно получиться что-то похожее: #app HelloWorld, Version="1.0.0.0", Author=developer, Command=/hello

Данная строка является обязательной для файла плагина!

8. Создайте zip архив с папкой {main_folder} (рекомендую воспользоваться архиватором 7-Zip со сжатием Нормальное)

Нужно заархивировать не саму папку, а её содержимое!

9. Переименуйте файл в {main_folder} и измените расширение архива на srp

10. Установите файл через Shark Remote

11. Тестируйте!

Вес установочного файла плагина (созданного архива) должен не превышать 10 мегабайт, иначе установить будет нельзя. Однако, если вы точно уверены в своём плагине, то можно использовать флаг big-bang=1 (подробнее)