Добро пожаловать в Документацию по AndroidAPS (AAPS)

Latest Release
4 June 2026 : Version 3.4.2.3 is out. Прочитайте Release Notes, чтобы узнать, что изменилось, для обновления воспользуйтесь инструкцией.
Android APS (AAPS) является приложением с открытым исходным кодом для людей, страдающих инсулинозависимым диабетом. Это система искусственной поджелудочной железы (APS), которая работает на смартфонах Android. AAPS использует алгоритм OpenAPS и нацелен на воплощение функциональности реальной поджелудочной железы - содержание СК (сахара, глюкозы в крови) в здоровых пределах при помощи автоматизированной подачи инсулина. Для использования AAPS вам понадобятся три совместимых с ним устройства: (1) Android телефон, (2) система непрерывного мониторинга за глюкозой (НМГ, англ: CGM) и (3) одобренная FDA/CE инсулиновая помпа. Дополнительно вам могут пригодиться облачные сервисы (4) для удаленного управления AAPS, передачи и сохранения ваших данных на сервере отчетов, так же будут полезными (5) умные часы.
Данная документация описывает процесс установки и использования AAPS. Вы можете перемещаться по документации AAPS либо при помощи левого меню (и полезной функции «Поиска в документации»), либо через оглавление внизу этой страницы.
Обзор документации AAPS
В разделе 2) Начало работы, введение описывает основную концепцию работы искусственной поджелудочной железы (ИПЖ, англ: APS). В нем описывается история замкнутых циклов в целом, почему был разработан AAPS, его сравнение с другими подобными системами и описание безопасности применения AAPS. Оно дает советы о том, как говорить с вашей врачебной командой об AAPS, рассказывает, почему вы должны собирать AAPS самостоятельно вместо простого скачивания сборки, показывает типичное подключение системы AAPS. Так же оно затрагивает доступность, и кому, вероятнее всего, полезнее использовать AAPS.
Подготовка к AAPS дает более детальную информацию о безопасности системы, рассказывает, какие телефоны, НМГ и инсулиновые помпы совместимы с AAPS. Она дает общую картину того, через что вам предстоит пройти, так же показывает примерную таблицу сроков получения полной функциональности AAPS. Эта секция позволяет технически подготовиться к сборке вашей конфигурации AAPS как можно более эффективно и быстро. Подраздел Настройка НМГ объясняет, как улучшить настройку НМГ, и какие опции сглаживания будут для вас наилучшими.
Теперь, когда у вас есть четкое понимание всего процесса, вы можете начать собирать свой цикл (петлю) на базе AAPS.
Раздел 3) Настройка AAPS содержит пошаговые инструкции того, как это можно сделать. Он рассказывает про выбор и настройку вашего сервера отчетов (Nightscout или Tidepool), чтобы вы могли наблюдать и делиться своими сахарами и терапией, содержит инструкции для подготовки к сборке приложения AAPS, саму его сборку, передачу установочного файла на ваш телефон. Так же в нем расположена информация про настройку приложения AAPS с помощью мастера установки, его связку с приложением вашего НМГ и либо реальной, либо виртуальной инсулиновой помпой, так же подключение AAPS к вашему серверу отчетов. Далее вам медленно будет представлена полная функциональность AAPS с помощью безопасного и хорошо отлаженного пошагового процесса, разработанного с целью убедиться в том, что вы или ваш ребенок хорошо ориентируетесь и разбираетесь во всех различных уровнях меню и настройках перед переходом к следующему этапу, часто именуемому следующей «Целью», вплоть до того момента, как у вас наберется достаточно опыта для использования более продвинутых настроек, доступных в программе. Данные цели специально разработаны таким образом, чтобы вы постепенно открывали все больше и больше возможностей AAPS и переключились с открытого цикла на замкнутый.
Раздел 4) Жизнь с AAPS покрывает основные возможности AAPS, помогая с использованием (и настройкой) AAPS. В том числе понимание всех экранов, активных углеводов (англ: COB, carbs on board), чувствительности, смены профилей, временных целей, растянутых углеводов (англ: eCarbs), автоматизаций и DynamicISF (динамического фактора чувствительности к инсулину). Так же он отвечает на часто задаваемые вопросы по типу того, что делать с различными типами еды, как отрабатывать смену канюли или сенсора НМГ, что делать с обновлениями ПО на смартфоне, переходом на летнее время, как путешествовать и заниматься спортом с AAPS. Частые вопросы и ответы на них находятся в секции «Решение проблем».
Раздел 5) Удаленный контроль за AAPS подчеркивает реальную силу AAPS. Имеется множество различных возможностей для удаленного управления или мониторинга AAPS. Данная секция одинаково полезна как для тех, кто заботится о детях с диабетом при помощи AAPS, так и для взрослых, которые хотят следить за своими показателями удобнее, чем на телефоне (на часах, в машине, т. д.), или для тех, кто хочет дать важным для них людям так же следить за показателями. Так же данный раздел описывает процесс настройки Android Auto для просмотра уровня СК в машине.
Раздел 6) Часы на Wear OS дает информацию и инструкции к умным часам на Wear OS с циферблатами AAPS или иными и как их использовать в функции пульта или просто дисплея AAPS.
Раздел 7) Обслуживание AAPS рассказывает, как экспортировать настройки и делать их резервную копию (что важно в случае потери/поломки телефона), описывает изменения последних версий и процесс обновления AAPS. Рассчитывайте на одну новую версию и 2-3 обязательных обновления в год. Следует своевременно устанавливать обновления, так как в AAPS как и в любом ПО, постоянно исправляются мелкие ошибки и появляются новые улучшения. Есть отдельный пункт «Обновление» в секции решения проблем с распространенными вопросами.
Раздел 8) Помощь направляет к источникам получения помощи по AAPS. Он позволит быстро связаться с другими пользователями, уточнить вопросы и разобраться с частыми ошибками новичков. Множество людей уже успешно применяют AAPS, но у всех однажды появляются вопросы, в которых трудно разобраться самостоятельно. Из-за большого числа пользователей, время ответа на вопросы как правило, лишь несколько часов. Не стоит волноваться по поводу просьбы о помощи, ведь глупых вопросов не бывает! Призываем пользователей любого уровня задавать столько вопросов, сколько необходимо для безопасной работы. Этот раздел включает в себя основные решения проблем с AAPS и AAPSClient (приложение-компаньон для удаленного мониторинга), а также отправить данные AAPS (журналы отладки) разработчикам при технической проблеме с AAPS.
Раздел **9) **Дополнительные возможности AAPS описывает такие темы, как переход от гибридного замкнутого цикла (использование болюсов на еду и т. п.) к автономному закрытому (без болюсов), опциям для разработчиков AAPS и инженерный режим. Большинство пользователей устроит основная («master») ветка AAPS без рассмотрения выше названных опций, этот раздел предназначен для тех, кто уже хорошо владеет замкнутым циклом и хочет улучшить свои показатели.
В разделе 10) Как поддержать AAPS мы рассказываем о способах поддержки проекта. Вы можете пожертвовать как денежные средства, так и оборудование или ваши навыки. Можно предлагать/вносить изменения в документацию самостоятельно, помогать с переводом документации и делиться своими показателями через проект Open Humans с научными сотрудниками.
Раздел 11) Ресурсы содержит устаревшую или дополнительную информацию, включая подраздел для медицинских работников, проявляющих интерес к такой технологии искусственной поджелудочной железы с открытым исходным кодом, как AAPS, или же для пациентов, кто хочет поделиться этой информацией с их лечащими врачами, эта тема так же раскрывается во введении. Больше информации про диабет и использование замкнутого цикла можно так же найти в этом разделе. Он включает глоссарий - список терминов и сокращений, использующихся в AAPS. Именно здесь вы узнаете, что обозначают термины по типу, например, ISF или TT.
Захотели начать работу с AAPS? Узнайте больше об AAPS во введении.
SAFETY NOTICE
Безопасность AAPS зависит от функций безопасности ваших устройств (телефона, помпы, сенсора НМГ). Используйте только полностью работоспособную, одобренную FDA/CE инсулиновую помпу и систему НМГ. Не используйте сломанные, модифицированные или самодельные инсулиновые помпы или трансмиттеры НМГ. Используйте только оригинальные расходники (сертеры, канюли и инсулиновые резервуары), одобренные производителем к использованию с вашей помпой или НМГ. Использование непроверенных или модифицированных расходников может привести к неточностям и ошибкам дозирования инсулина, что создаст значительный риск для пользователя.
Не пользуйтесь AAPS, если вы принимаете ингибиторы SGLT-2 (глифлозины), поскольку они снижают уровень СК. Этим вы увеличиваете риск диабетического кетоацидоза (DKA) из-за сниженной подачи инсулина и гипогликемии из-за пониженного уровня СК.
Disclaimer
Вся информация и исходный код, описанные здесь, предназначены только лишь для ознакомительных и образовательных целей. Используйте Nightscout и AAPS на свой страх и риск, не используйте данную тут информацию или исходный код для принятия медицинских решений. Nightscout в настоящее время не обеспечивает соблюдение политик конфиденциальности HIPAA (Health Insurance Portability and Accountability Act — Акт о мобильности и подотчётности медицинского страхования).
Использование исходного кода с github.com не дает никакой гарантии и какой-либо официальной поддержки. Пожалуйста, ознакомьтесь с файлом LICENSE внутри репозитория.
Все наименования продуктов и компаний, товарные знаки, услуги по обслуживанию, зарегистрированные товарные знаки и зарегистрированные службы являются собственностью соответствующих владельцев. Они используются в информационных целях и не подразумевается какой-либо принадлежности к ним или их одобрения.
AAPS не связан с данными организациями и не признан ими: SOOIL, Dexcom, Accu-Chek, Roche Diabetes Care, Insulet или Medtronic.
Оглавление документации AAPS
1) Изменение языка
2) Начало работы
- Введение в AAPS
- Что такое система искусственной поджелудочной железы”?
- Что значит гибридный замкнутый цикл?
- Как и почему появились системы ИПЖ?
- Что такое Android APS (AAPS)?
- Основные компоненты AAPS
- Преимущества системы AAPS
- К практическим преимуществам относятся:
- 1) Встроенная безопасность
- 2) Аппаратная адаптивность
- 3) Настраиваемость в широком диапазоне
- 4) Удаленный мониторинг
- 5) Дистанционное управление
- 6) Отсутствие коммерческих ограничений из-за открытого интерфейсов приложений
- 7) Детализированный интерфейс приложения
- 8) Социальная и финансовая доступность
- 9) Поддержка
- 10) Предсказуемость, легкость и безопасность управления
- 11) Доступ к расширенным функциям через режимы разработки (dev), включая полный цикл
- 12) Возможность вносить вклад в дальнейшие улучшения
- К практическим преимуществам относятся:
- Как выглядит AAPS в сопоставлении с традиционными инъекциями и открытым циклом?
- Сравнение AAPS с другими системами ИПЖ
- Использует ли AAPS искусственный интеллект или какой-либо обучающий алгоритм?
- Какая система подходит мне или моим подопечным?
- Безопасно ли пользование системами с открытым исходным кодом, такими как AAPS?
- Как мне подойти к обсуждению AAPS с врачами?
- В: Почему нельзя просто скачать AAPS и не начать им сразу же пользоваться?
- В: Какова структура системы AAPS?
- В: Каким образом развивается и совершенствуется AAPS?
- Кто может получить пользу от применения AAPS?
- Какие преимущества можно получить от AAPS?
- Подготовка к AAPS
- Finding your way around the documentation
- Безопасность прежде всего
- Техническая безопасность
- Медицинская безопасность
- Не использовать SGLT-2 ингибиторы
- Главные принципы работы системы ИПЖ на базе AAPS
- Что мы будем собирать и устанавливать?
- How long will it take to set everything up?
- Что потребуется:
- Обзор компонентов
- - Совместимые помпы
- - Совместимые НМГ
- - Совместимые телефоны
- - Совместимые умные часы
3) Настройка AAPS
- Настройка сервера отчетов
- - Nightscout
- - Tidepool
- Сборка AAPS
- - Браузер
- Постройте сами вместо скачивания
- Технические характеристики устройства и программного обеспечения для построения AAPS
- 1. Своя ветка с AAPS
- 2. Подготовительные шаги
- AAPS-CI GitHub Actions to Build the AAPS APK
- AAPS-CI Troubleshooting
- If you want to add a specific commit to your branch, please use cherry-pick.
- CI KeyStore Export
- - Android Studio
- - Командная строка
- Передача и установка AAPS
- Мастер установки
- Приветственное сообщение
- Лицензионное соглашение
- Необходимые разрешения
- Master password
- Units (mg/dL <-> mmol/L)
- Параметры экрана
- Синхронизация с сервером отчетов и другие вопросы
- Patient name
- Patient type
- Применяемый инсулин
- Источник ГК
- Profile
- Инсулиновая помпа
- APS algorithm
- Определение чувствительности
- Начните выполнение Цели 1
- Restart AAPS to validate settings
- Профиль AAPS
- Изменение настроек AAPS
- - Конфигуратор
- - Настройки
- General
- Защита
- Общие замечания
- Keep screen on
- Buttons
- Мастер быстрых настроек
- Default temp targets
- Fill/Prime standard insulin amounts
- Range for visualization
- Shorten tab titles
- Show notes field in treatments dialogs
- Индикаторы состояния
- Deliver this part of bolus wizard result
- Old glycemia time threshold
- Enabled bolus advisor
- Enabled bolus reminder
- Advanced Settings (Overview)
- Безопасность терапии
- Замкнутый цикл
- Улучшенный ассистент приема пищи (AMA) или Супер Микро Болюс (SMB)
- Настройки усваиваемости
- Pump
- Настройки помпы
- Tidepool
- клиент NS
- Клиент NSV3
- СМС-коммуникатор
- Автоматизация
- Локальные оповещения
- Параметры обслуживания
- Проект Open Humans
- Прохождение целей
- Backup your settings
- Objective 1: Setting up visualization and monitoring, analyzing basals and ratios
- Цель 2: Научитесь контролировать AAPS
- Цель 3: Подтвердите ваши знания
- Цель 4: Начните с открытого цикла
- Цель 5: Глубже понимаем работу системы в режиме незамкнутого цикла, включая ее рекомендации по временным базалам
- Цель 6: Начинаем замыкать цикл с Low Glucose Suspend (прекращением подачи инсулина на низких сахарах)
- Цель 7: Настройка замкнутого цикла с поднятием макс величины IOB выше 0 и постепенным понижением целевой ГК
- Objective 8: Adjust basals and ratios if needed, and then enable Autosens
- Цель 9: Активация таких дополнительных функций для дневного времени как супер микро болюс SMB
- Цель 10: Автоматизация
- Возможность возврата к предыдущим целям
4) Жизнь с AAPS
- Экраны AAPS
- Главный экран
- Мастер Болюса
- Вкладка «Действия»
- Профиль инсулина
- Статус помпы
- Замкнутый цикл, помощник болюса AMA / микроболюсы SMB
- Profile
- Автоматизация
- клиент NS
- Источник ГК - xDrip+, BYODA…
- Терапия
- Просмотр журнала
- Statistics
- Profile Helper
- Основные функции AAPS
- Loop mode
- Autosens
- Super Micro Bolus (SMB)
- Advanced Meal Assist (AMA)
- Overview of hard-coded limits
- Расчет COB
- Определение чувствительности
- Смена профиля & процент профиля
- Временные цели
- Что такое временные цели, где их можно задать и сконфигурировать?
- Как выбрать временную цель?
- Как изменить временную цель по умолчанию и переопределить её своими собственными значениями?
- Как отменить Врем-Цель?
- Как выбрать «Временные цели по умолчанию»
- Временная цель Гипо
- Временная цель Нагрузка
- Временная цель Ожидаемый прием пищи
- Как отключить СМБ во время активной Временной-Цели?
- Растянутые углеводы
- Автоматизации
- Что такое автоматизация?
- Как может помочь автоматизация
- Основные соображения перед началом применения автоматизации
- Когда начать применять Автоматизацию?
- Где находятся настройки автоматизации в AAPS?
- Как настроить автоматизацию?
- Ограничения безопасности
- Правильное использование отрицательных значений
- Automation Triggers
- Действие
- Порядок автоматизаций в списке играет роль
- Как удалить правила автоматизации
- Examples of Automations
- Automating Preference Settings Export
- Automation Logs
- Устранение неполадок
- Устранение неполадок
- Alternatives to Automations
- Динамический ISF
- AAPS для детей
- Помпы и канюли
- Путешествия между часовыми поясами & летнее время
5) Удаленный контроль за AAPS
- Удаленный мониторинг
- Удаленное управление
- SMS команды
- Безопасность прежде всего
- Настройка SMS-команд
- SMS commands usage
- Команды
- Troubleshooting and FAQ
- What can’t we do with SMS commands?
- What happens if I change my mind about a command I have just sent?
- Why didn’t I get a response to an SMS command?
- No response whatsoever for SMS commands
- Errors carrying out commands
- How can I stop a command once it has been authenticated?
- Несколько SMS
- I am getting far too many text messages from SMS Commands. Can I reduce the frequency, or make them stop?
- Только наблюдение
- Android Auto
6) Часы на Wear OS
- AAPS для Wear OS
- Использование умных часов
- Wear OS Versions and compatibility
- How to set up a Samsung Galaxy 4 smartwatch with AAPS
- Basic smartwatch familiarity
- Setting up a Samsung account
- Transferring the AAPS Wear app onto your AAPS phone
- Setting up the connection between the watch and the phone from AAPS
- Changing to an AAPS Watchface on your WearOS watch
- AAPSv2 watchface - Legend
- Удаленное управление
- Циферблаты AAPS
- Configuration
- Доступ к главному меню AAPS
- Параметры (в часах Wear)
- Усложнения (дополнительные функции)
- Плитки Wear OS
- Как добавлять плитки
- Всегда включен
- Ярлык Отложить оповещения
- Советы по производительности и автономности батареи
- Устранение неполадок в приложении Wear:
- Additional AAPS custom watchfaces are also available
- Build your own watchface
- Пользовательские циферблаты
- Формат настраиваемых циферблатов
- JSON Structure
- How to build/design your first Watchface
- Advanced features
- Key and KeyValue reference
- Обмен пользовательскими циферблатами
7) Обслуживание AAPS
- Экспорт/Импорт настроек
- Анализ данных
- Примечания к изменениям в версиях AAPS
- Версия Android и версия AAPS
- Версия WearOS
- Version for 3.4.2.3
- Version 3.4.2.2
- Version 3.4.2.1
- Version 3.4.2.0
- Version 3.4.1.0
- Version 3.4.0.0
- Version 3.3.2.1
- Version 3.3.2.0
- Version 3.3.1.3
- Version 3.3.1.2
- Version 3.3.1.0
- Version 3.3.0.0
- Version 3.2.0.4
- Версия 3.2.0.0, посвященная @Philoul
- Версия 3.1.0
- Версия 3.0.0
- Версия 2.8.2
- Версия 2.8.1.1
- Версия 2.8.0
- Версия 2.7.0
- Версия 2.6.1.4
- Версия 2.6.1.3
- Версия 2.6.1.2
- Версия 2.6.1.1
- Версия 2.6.1
- Версия 2.6.0
- Версия 2.5.1
- Версия 2.5.0
- Версия 2.3
- Версия 2.2.2
- Версия 2.2
- Версия 2.1
- Версия 2.0
- Version 1.0
- Обновление документации
- March 2026
- January 2025
- December 2025
- October 2025
- August 2025
- May 2025
- January 2025
- December 2024
- November 2024
- October 2024
- Февраль 2022
- Январь 2022
- Декабрь 2021
- ноябрь 2021
- Октябрь 2021
- Сентябрь 2021 года
- Июнь 2021
- Апрель 2021
- Март 2021
- Февраль 2021
- Январь 2021
- Декабрь 2020
- Октябрь 2020
- Сентябрь 2020 года
- Июнь 2020
- Май 2020
- Апрель 2020
- Март 2020
- Февраль 2020
- Январь 2020
- Декабрь 2019
- ноябрь 2019
- Октябрь 2019
- Сентябрь 2019 года
- Август 2019
- Переход на новую версию AAPS
- - Через браузер
- - Через Android Studio
8) Поддержка
- Где можно получить помощь с AAPS
- Решение известных проблем
- - Проблемы с Bluetooth
- Инструкции по тонкой настройке
- Решение проблем с Android Studio
- Потеряно хранилище ключей
- Ошибка синхронизации Gradle
- Generate Signed APK успешно сгенерировано с 0 вариантами сборки
- Приложение было создано с предупреждениями компилятора/kotlin
- AAPS не получает данные мониторинга CGM
- Apk not installed
- Apk installed but old version
- Ничего из вышеперечисленного не сработало
- Сценарий худшего варианта
- Доступ к лог-файлам
9) Продвинутые опции AAPS
- Автономный замкнутый цикл
- Чего ожидать?
- Общие соображения, почему (не) переходить с неполного на автономный замкнутый цикл
- Правильно настроенный гибридный замкнутый цикл
- Инсулины короткого действия (Lyumjev, Fiasp)
- Предварительные требования
- Ограничения, относящиеся к приему пищи
- Подготовка к физическим нагрузкам
- Сложности для детей
- Включение повышенного SMB; безопасность
- Обнаружение приёма пищи/ Автоматизация для повышения эффективности
- Hypo prevention
- Устранение неполадок
- Ветка dev
- Автотюн
10) Как поддержать AAPS
- Чем я могу помочь
- Редактирование документации
- General
- Code syntax
- Tables
- Style Guide
- Contents
- 1. English language writing tips
- Use language that is appropriate for the reader
- Privacy/licensing concerns:
- Keep sentences short, get to the point
- Don’t be afraid to give instructions
- Mostly use active verbs, rather than passive verbs
- Avoid nominalisations
- Use lists where appropriate
- Mythbusting
- Optimizing writing style by purpose
- 2. AAPS-specific writing/updating notes
- 3. Useful References
- Перевод приложения и документации
- Состояние переводов
- Выгрузка в Open Humans
11) Ресурсы
- Глоссарий
- Часто задаваемые вопросы
- General
- APS algorithm
- Other settings
- Frequent questions on Discord and their answers…
- My problem is not listed here.
- My problem is not listed here but I found the solution
- AAPS stops everyday around the same time.
- How to organize my backups ?
- I have problems, errors building the app.
- I’m stuck on an objective and need help.
- How to reset the password in AAPS v2.8.x ?
- How to reset the password in AAPS v3.x
- My link/pump/pod is unresponsive (RL/OL/EmaLink…)
- Build error: file name too long
- Alert: Running dev version. Closed loop is disabled
- Where can I find settings files?
- How to configure battery savings?
- Pump unreachable alerts several times a day or at night.
- Where can I delete treatments in AAPS v3 ?
- Configuring and Using the AAPSClient remote app
- I have a red triangle / AAPS won’t enable closed loop / Loops stays in LGS / I have a yellow triangle
- Can I move an active DASH Pod to other hardware?
- Procedure I follow in this:
- How do I import settings from earlier versions of AAPS into AAPS v3 ?
- Основные ресурсы по диабету и ИПЖ
- Отдельный аккаунт Google для AAPS (по желанию)
- Как создать специальную учетную запись Google для AAPS
- Go to https://account.google.com
- Enter your NEW dedicated account details:
- Введите личные данные:
- Choose your NEW email address & password
- Enter a phone number which can receive the SMS verification
- Enter the recovery email address
- Завершите регистрацию учетной записи
- Настройте отображение нового профиля
- Откройте веб-сайт Gmail в обоих окнах для настройки новой учетной записи
- In the new Gmail account (bottom window), open Gmail settings…
- Настройка переадресации…
- Подтверждение адреса переадресации электронной почты
- Архивируйте переадресованные письма в новом специально выделенном аккаунте Gmail (в нижнем окне)
- Как создать специальную учетную запись Google для AAPS
- Медицинским работникам (устарело)
- Этапы самостоятельного создания системы замкнутого цикла:
- Как работает замкнутый цикл
- Как собираются данные:
- Откуда он знает, что делать?
- Примеры принятия решений алгоритмом AAPS:
- Ниже приведены примеры фиолетовых линий прогнозирования, а также то, как они могут различаться:
- Ниже приведены примеры различных временных рамок, влияющих на изменения в подаче инсулина:
- Сценарий 1- Нулевая ВБС для безопасности
- Сценарий 2- Нулевая ВБС для безопасности
- Сценарий 3 - Требуется больше инсулина
- Сценарий 4 - Пониженная ВБС для безопасности
- Оптимизация параметров и внесение изменений
- OpenAPS
- Вывод