.. _gsauto_ug_intro:


Руководство пользователя
========================

Руководство предназначено для начального изучения библиотеки `gs-automation`.

.. note::
   Для эффективного освоения материала рекомендуется иметь практический опыт работы с:
   
   1. `Java <https://docs.oracle.com/javase/specs/jls/se11/html/index.html>`__
   2. `JUnit <https://docs.junit.org/current/user-guide>`__
   3. `Gradle <https://docs.gradle.org/current/userguide/userguide.html>`__
   4. `HTML <https://www.w3schools.com/html>`__
   5. :term:`Global3 ApplicationServer <AS>`

Библиотека `gs-automation` предназначена для разработки программ, автоматически 
взаимодействующих с пользовательским интерфейсом системы Global3. Это могут быть 
как :ref:`самостоятельные приложения, так и UI-тесты <gsauto_ug_usage>`.

Библиотека используется совместно с сервером приложений системы Global3. Сервер 
приложений должен быть настроен :ref:`специальным образом <gsauto_ug_prepare>`.

Взаимодействие с интерфейсом осуществляется посредством обнаружения его :ref:`элементов <gsauto_ug_objects>`
и передачи в них событий от :ref:`устройств ввода <gsauto_ug_interaction>`.


Полное описание библиотеки находится в :ref:`справочнике по API <gsauto_api>` библиотеки 
и её дополнительных компонент.

К этому руководству :ref:`прилагаются <gsauto_ug_appendix>` демонстрационные примеры простых проектов приложений
и UI-тестов.



.. toctree::
   :maxdepth: 1
   :includehidden:
   :titlesonly:
   :hidden:

   prepare/index.rst
   usage/index.rst
   objects/index.rst
   interaction/index.rst
   appendix/index.rst