Android release-сборка падает из-за пути длиннее 260 символов: проверяем короткий корень. Практическая проверка: зафиксировать полный путь из первой ошибки, не менять реестр сразу, скопировать тот же commit в короткий временный корень и повторить release-сборку; если ошибка исчезла, сократить корень или явно проверить обе предпосылки Windows long.
Сначала зафиксируйте именно этот симптом
Debug-вариант Android-приложения собирается в Windows, а release падает на сгенерированном пути длиннее 260 символов; пользователь готов менять реестр или переустанавливать инструменты, не проверив влияние длинного корня проекта и поддержку long paths конкретным процессом. Точный запрос пользователя: почему Android Gradle release-сборка в Windows падает с ошибкой path exceeds 260 characters, хотя debug собирается, и как безопасно отделить длину корня проекта от поддержки long paths. Свежий публичный сигнал описывает границу так: Официальный Stack Exchange API возвращает датированный 27 августа 2026 года вопрос о падении Android release-сборки на Windows из-за пути длиннее 260 символов при успешной debug-сборке; вопрос подтверждает только наличие сценария, но не причину или распространённость. Он подтверждает существование сценария «Android release-сборка падает из-за пути длиннее 260 символов: проверяем короткий корень», но не назначает виновный компонент и не показывает масштаб. До проверки запишите только наблюдаемое: версию, поверхность продукта, момент события и воспроизводимый шаг. Личные имена, адреса, содержимое аккаунта и закрытые ссылки для этого не нужны. Если симптом нельзя повторить на безопасном примере, остановитесь на сборе фактов и не меняйте конфигурацию наугад.
Проверка по отдельным контрольным шагам
Зафиксировать полный путь из первой ошибки, не менять реестр сразу, скопировать тот же commit в короткий временный корень и повторить release-сборку; если ошибка исчезла, сократить корень или явно проверить обе предпосылки Windows long paths — системную настройку и opt-in процесса — затем перезапустить процесс и повторить контроль. Разложите эту последовательность на отдельные контрольные действия. Шаг 1: Зафиксировать полный путь из первой ошибки. Шаг 2: Не менять реестр сразу. Шаг 3: Скопировать тот же commit в короткий временный корень и повторить release-сборку. Шаг 4: Если ошибка исчезла. Шаг 5: Сократить корень или явно проверить обе предпосылки Windows long paths — системную настройку и opt-in процесса — затем перезапустить процесс и повторить контроль. После каждого шага сохраните ожидаемый и фактический результат, не переходя сразу к следующему. Контрольная переменная для этой статьи — именно «дерево «длина фактического пути → короткий корень на том же commit → системная настройка → longPathAware конкретного процесса» отделяет обратимый тест расположения проекта от глобальной настройки Windows и задаёт стоп-линию перед изменением реестра или очисткой кэшей». Изменяйте одно условие, затем возвращайте его в исходное состояние. Если различие исчезло после отката и вернулось при повторе, ветка подтверждена наблюдением; если нет, зафиксируйте отрицательный результат и переходите к следующей границе, не расширяя права и не очищая данные.
Границы, которые задают источники
Документ 1: Официальная документация Microsoft описывает ограничение MAX_PATH в 260 символов для многих Win32 API и две независимые предпосылки снятия ограничения: системный LongPathsEnabled и объявление longPathAware в манифесте приложения; значение реестра кэшируется процессом, поэтому после изменения нужен новый процесс. Документ 2: Официальная документация Gradle показывает, что каталог build внутри корня проекта содержит генерируемые результаты сборки; поэтому длина корня проекта входит в полный путь к промежуточным release-артефактам и может быть проверена обратимым переносом того же commit в короткий временный путь. Эти документы подтверждают только перечисленные свойства и ограничения. Их нельзя растягивать на другую версию, роль, платформу или сетевую схему без отдельной проверки. Форумный или новостной сигнал не заменяет документацию: он задаёт вопрос «почему Android Gradle release-сборка в Windows падает с ошибкой path exceeds 260 characters, хотя debug собирается, и как безопасно отделить длину корня проекта от поддержки long paths», а ответ строится по первичным формулировкам выше. Если интерфейс, версия или результат расходятся с документом, отметьте расхождение как неизвестное и приложите к обращению ссылку и дату проверки, а не предположение о причине.
Развилки решения и стоп-линия
Дерево «длина фактического пути → короткий корень на том же commit → системная настройка → longPathAware конкретного процесса» отделяет обратимый тест расположения проекта от глобальной настройки Windows и задаёт стоп-линию перед изменением реестра или очисткой кэшей. Практическая развилка начинается с результата последовательности: зафиксировать полный путь из первой ошибки, не менять реестр сразу, скопировать тот же commit в короткий временный корень и повторить release-сборку; если ошибка исчезла, сократить корень или явно проверить обе предпосылки Windows long paths — системную настройку и opt-in процесса — затем перезапустить процесс и повторить контроль. Если первый обратимый тест меняет симптом, повторите его на исходном состоянии и сохраните обе строки сравнения. Если результат одинаков, не делайте вывод о поломке всего продукта — переходите к следующему слою, названному в матрице для «Android release-сборка падает из-за пути длиннее 260 символов: проверяем короткий корень». Стоп-линия наступает перед удалением профиля, сбросом, выдачей широких разрешений, ослаблением защиты или изменением чужих данных. Минимальный пакет поддержки: обезличенный симптом, версия клиента и ОС, UTC-время, выбранная ветка, одно изменённое условие, ожидаемый и фактический результат. Пароли, токены, IP-адреса, серийные номера и полные логи исключите.
Материал подготовлен редакцией VOne с применением ИИ для структурирования дерева проверки, но каждый технический тезис вручную сопоставлен с указанными официальными, первичными или исследовательскими источниками; форумный либо новостной сигнал использован только как лид и не считается доказательством причины или популярности.
Источники и проверка
- learn.microsoft.com — проверенный источник проверено 2026-08-27
- docs.gradle.org — проверенный источник проверено 2026-08-27
Информация актуальна на дату публикации. Правила сервисов, приложений и сетей могут меняться.