AppFunction не появляется в Android 17: проверка service entry и реестра. Отделить область применимости от похожего симптома, провести один обратимый контроль и оформить цепочка «annotation → KSP output → service entry → app metadata → registry item» без лишних данных.
Где проходит граница симптома
Пользовательская боль: агент не видит новую функцию приложения, хотя аннотация присутствует и сборка устанавливается. До вмешательства зафиксируйте пользовательский результат одной фразой и отделите его от предполагаемой причины. Нужны build, app version и один безопасный контроль, а не полный профиль устройства. Совпадение по времени с обновлением — только гипотеза. Граница поискового намерения: почему AppFunction не видна в реестре Android 17 и как проверить регистрацию. Соседние неисправности не включаются в этот материал и требуют отдельного evidence.
Что подтверждено официально
Android Developers сообщает: AppFunctions компилируются в type-safe sandboxed tool definitions; для регистрации нужен AppFunctionService entry point и app metadata, а список функций можно проверить ADB-командой list-app-functions. Официальное утверждение ограничено указанной версией, API и capability; оно не доказывает распространённость и не переносится на неподдерживаемое hardware. Проверяйте фактическую область применимости до вывода. Проверяемый выход статьи — цепочка «annotation → KSP output → service entry → app metadata → registry item». Он нужен, чтобы официальный факт не превращался в универсальную догадку о любой похожей ошибке.
Какие данные нужны до проверки
Минимальный набор: версия appfunctions и compiler, имя сгенерированного service, manifest metadata, package name и результат list-app-functions. Сделайте таблицу входных параметров до первого запуска. Каждое unknown оставьте пустым. Так последующий результат можно связать с одной настройкой, не смешивая dependency, hardware и UI state. До опыта сформулируйте безопасный stop: не предоставлять агенту privileged-доступ вне тестового устройства и не публиковать manifest с внутренними endpoints. Если он уже наступил, не собирайте дополнительные данные ради полноты отчёта.
Обратимый контроль
Практический шаг: на debug-профиле собрать приложение заново, проверить generated service и manifest, затем сравнить список реестра до и после одной исправленной записи. Выполните A, затем B и обязательный возврат к A. Между шагами записывайте только наблюдаемый ответ. Reset, переустановка и выдача широких permissions не входят в первый опыт и уничтожают причинную связь. Контроль не должен выходить за исходный scope: версия appfunctions и compiler, имя сгенерированного service, manifest metadata, package name и результат list-app-functions. Любой дополнительный параметр переносится в новую отдельную проверку.
Как читать полученный результат
Рабочий артефакт: цепочка «annotation → KSP output → service entry → app metadata → registry item». Заполните baseline, controlled change и rollback отдельными строками. Статус выбирается из confirmed here, not reproduced или stopped. Локальный pass не доказывает поддержку всех моделей и версий. Сопоставляйте результат с точным действием: на debug-профиле собрать приложение заново, проверить generated service и manifest, затем сравнить список реестра до и после одной исправленной записи. Совпадение во времени без controlled change не считается причинной связью.
Стоп-линия и пакет поддержки
Критерий остановки: не предоставлять агенту privileged-доступ вне тестового устройства и не публиковать manifest с внутренними endpoints. Для issue достаточно model family без serial, build, app/library version, три шага, expected/actual и официальный URL. Удалите contacts, paths, IP/MAC, tokens, media и full dumps; неподдающееся очистке вложение не отправляйте. В support package назовите пользовательскую боль без личных деталей: агент не видит новую функцию приложения, хотя аннотация присутствует и сборка устанавливается. Остальные сведения добавляйте только если они меняют воспроизводимость.
Материал подготовлен редакцией VOne с помощью ИИ; технические утверждения постатейно сверены с указанными официальными источниками 28 августа 2026 года.
Источники и проверка
- Android Developers Blog — AppFunctions integration проверено 2026-08-28
- Android Developers Blog — Android 17 is here проверено 2026-08-28
Информация актуальна на дату публикации. Правила сервисов, приложений и сетей могут меняться.