AutoIt

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

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

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

Далее можете продолжить следовать инструкции или скачать готовый пример и на его основе создать свой плагин. Чтобы установить данный плагин, не распаковывая, перетащите файл на список установленных плагинов. Для просмотра и редактирования рекомендую воспользоваться архиватором 7-Zip со сжатием Нормальное.

Пример готового плагина

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

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

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

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

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

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, но этот параметр и значение необходимы для корректной обработки плагина.

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

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

main.au3
#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 (подробнее)

Last updated