Google 서비스 없이 Element Android 알림 설정하기: UnifiedPush 가이드

Element 앱은 실행 중일 때는 메시지를 정상적으로 수신하지만, 화면이 잠긴 후에는 알림이 오지 않을 수 있습니다. Google Play 서비스가 설치되지 않은 Android 휴대폰의 경우, 이는 Matrix 계정 자체의 문제가 아니라 메시지 전송 경로의 문제일 가능성이 높습니다. 이 가이드의 목표는 단순히 테스트 알림 하나를 표시하는 것이 아닙니다. Element 앱이 백그라운드에서 실행 중인 상태에서 휴대폰이 유휴 상태일 때, 그리고 앱을 다시 열지 않고도 메시지가 정상적으로 수신되는 결과를 얻는 것이 중요합니다.

이 가이드는 Element에서 신규 사용자에게 권장하는 최신 Android용 Element X 버전을 중점적으로 다룹니다. 2026년 10월 6일 기준, 최신 공개 GitHub 릴리스는 Element X Android 26.09.4이며, 최근 릴리스에는 UnifiedPush 구성 요소가 포함되어 있습니다. UnifiedPush는 Android 앱이 Google의 Firebase Cloud Messaging(FCM) 외의 다른 배포자를 통해 푸시 메시지를 수신할 수 있도록 하는 개방형 프로토콜입니다. Element 프로젝트 가이드라인에 따르면 UnifiedPush 배포자를 설치하면 Element X에서 이를 감지하여 푸시 제공자로 제공할 수 있습니다. Element X Android 저장소 , Element X Android 릴리스 및 Google Play 서비스 없이 알림을 받는 방법 에 대한 Element 팀의 논의를 참조하세요 .

성공적인 해결책은 이런 모습이어야 합니다.

설정을 변경하기 전에 달성하고자 하는 결과를 명확히 정의하십시오. 알림 설정은 다음 모든 조건이 충족될 때 정상적으로 작동합니다.

• Android는 Element에 대한 알림을 허용합니다.
• ntfy, Sunup 또는 기타 지원되는 UnifiedPush 배포판이 설치되어 실행 중입니다.
• Element X는 해당 배포자를 활성 푸시 제공업체로 표시합니다.
• 배포 앱은 백그라운드에서 실행될 수 있으며 안드로이드의 배터리 제한 상태로 설정되지 않습니다.
• Element가 완전히 백그라운드에서 실행되는 동안 다른 Matrix 계정에서 보낸 메시지가 도착합니다.
• 휴대전화가 몇 분 동안 사용되지 않은 상태라도 동일한 테스트는 여전히 작동합니다.

Element 앱을 실행한 후에만 메시지가 표시된다면 동기화는 되지만 백그라운드에서 안정적으로 전송되지 않는 것입니다. 앱이 열려 있을 때는 메시지가 즉시 표시되지만 앱을 닫으면 지연되어 표시되는 경우, 룸 알림 규칙보다는 푸시 알림 배포자와 Android 백그라운드 제한 사항에 집중해야 합니다.

Google 서비스 없이 알림이 작동하지 않는 이유는 무엇입니까?

대부분의 주류 안드로이드 애플리케이션은 새로운 데이터가 있을 때 앱을 깨우기 위해 구글의 푸시 서비스인 FCM을 사용합니다. Element의 알림 문서에 따르면 FCM은 Google Play 서비스가 필요합니다. 구글 서비스가 제거된 휴대폰에서는 FCM만 사용하는 설정으로는 정상적인 앱 활성화 경로를 제공할 수 없습니다. 또한 안드로이드는 특히 기기가 유휴 상태가 될 때 일반 애플리케이션이 백그라운드에서 수행할 수 있는 작업을 제한합니다.

UnifiedPush는 해당 종속성을 배포자로 대체합니다. 배포자 는 푸시 연결을 유지하고 등록된 애플리케이션에 수신 알림을 전달하는 Android 앱입니다. UnifiedPush 프로젝트는 ntfy, Sunup, NextPush, gCompat-UP 등의 옵션을 제공합니다. 공식 UnifiedPush 배포자 목록을 참조하세요 .

1단계: Android에서 Element 알림 표시가 허용되어 있는지 확인합니다.

가장 간단한 오류 원인부터 확인해 보세요. 안드로이드 13 이상에서는 POST_NOTIFICATIONS일반 알림이 표시되려면 앱에 런타임 권한이 필요합니다. 안드로이드 설정에서 Element X 앱을 찾아 알림이 허용되어 있는지 확인하세요. 또한, 안드로이드 버전이나 제조사에서 제공하는 경우 개별 알림 카테고리도 확인해 보세요.

안드로이드 공식 문서에 따르면 안드로이드 13 이상 버전에 새로 설치된 앱은 사용자가 권한을 부여하기 전까지 일반 알림을 보낼 수 없습니다. 안드로이드 알림 권한 문서를 참조하세요 .

품질 점검: Android에서 알림이 비활성화된 것으로 표시되면 먼저 해당 문제를 해결하고 다시 테스트하십시오. 알림이 이미 허용되어 있는데도 Element가 백그라운드에서 실행되는 동안 알림이 도착하지 않으면 푸시 알림 제공업체를 확인하십시오.

2단계: UnifiedPush 배포자를 설치하고 활성화합니다.

사용 중인 기기에 적합한 소스에서 UnifiedPush 배포 도구를 설치하세요. ntfy는 공용 서버 또는 자체 호스팅 서버를 사용할 수 있어 널리 사용됩니다. ntfy용 UnifiedPush 빠른 시작 가이드에서는 ntfy를 설치하고, 필요한 알림 및 배터리 권한을 부여한 다음, 호환되는 애플리케이션에서 ntfy를 배포 도구로 선택하도록 안내합니다. 자세한 내용은 ntfy 공식 UnifiedPush 빠른 시작 가이드를 참조하세요 .

ntfy를 열고 UnifiedPush 지원이 활성화되어 있는지 확인하세요. 자체 호스팅 ntfy 서버를 사용하는 경우 Android 앱이 해당 서버에 연결되어 있는지, 그리고 휴대폰의 현재 네트워크에서 HTTPS를 통해 서버에 접속할 수 있는지 확인하세요.

품질 점검: ntfy가 설치되어 있는 것만으로는 충분하지 않습니다. 배포자가 활성화되어 있고 접근 가능한 상태여야 합니다. 설치 후 Element에서 배포자를 찾을 수 없는 경우, Element X를 완전히 종료했다가 다시 실행한 다음, 서버 측 Matrix 설정을 변경하기 전에 앱 업데이트를 확인하십시오.

3단계: Element X 내에서 UnifiedPush 공급자를 선택합니다.

Element X 설정에서 알림 영역으로 이동하세요. 호환되는 푸시 알림 배포자가 감지되면 Element X에서 푸시 알림 제공자 선택 화면이 나타납니다. Firebase/FCM 대신 설치된 UnifiedPush 배포자를 선택하세요. Element 프로젝트 관리자는 Google 서비스가 설치되지 않은 기기에 대해 이 과정을 명시적으로 설명했으며, 현재 소스 코드에는 UnifiedPush 푸시 알림 제공자 모듈이 포함되어 있습니다.

배포판을 설치한 후에도 공급자 선택기가 표시되지 않으면 홈서버에 문제가 있는 것으로 간주하지 마십시오. 먼저 Element X를 최신 지원 빌드로 업데이트하고 Element X와 배포판을 모두 다시 시작하십시오. Element X 릴리스에 따라 UI 레이블이 변경되었으므로 정확한 메뉴 이름이 다를 수 있습니다.

품질 점검: 제공업체 이름이 표시되는 것만으로는 충분하지 않습니다. Element가 백그라운드 상태일 때 다른 Matrix 계정으로 실제 메시지를 보내보세요. 정상적으로 작동하는 제공업체라면 Element 앱이 자동으로 실행되어 앱을 수동으로 열지 않아도 메시지 알림이 표시되어야 합니다.

4단계: 유통업체에서 배경 제한을 해제합니다.

UnifiedPush는 배포자가 항상 연결 가능한 상태를 유지해야 합니다. Android가 ntfy 또는 다른 배포자를 배터리 제한 상태로 설정하면 푸시 알림 연결이 중단될 수 있습니다. Android는 대부분의 기기에서 세 가지 주요 백그라운드 배터리 모드(무제한, 최적화, 제한)를 지원합니다. 제한 모드에서는 앱이 의존하는 작업, 알림 및 포그라운드 서비스 동작이 차단될 수 있습니다.

배포판의 Android 설정에서 배터리 사용량 설정을 '제한됨'에서 '제한 없음'으로 변경하세요. 단, 알림이 지연되거나 유휴 상태일 때 사라지는 경우에 해당합니다. Element X 자체를 검사하여 명시적으로 제한되어 있지 않은지도 확인할 수 있습니다. 제조사별 Android 빌드에서는 자동 시작, 백그라운드 데이터 또는 앱 절전 모드에 대한 별도의 제어 기능이 추가될 수 있습니다.

Google의 Android 문서에 따르면 사용자가 '제한됨' 상태를 선택하면 일부 기기에서 앱이 백그라운드에서 실행되지 않도록 완전히 차단할 수 있습니다. Android 백그라운드 최적화 지침을 참조하세요 .

품질 점검: 휴대폰을 잠그고 10~20분 동안 그대로 둔 다음, 다른 계정으로 몇 개의 메시지를 보내 보세요. 알림이 신속하고 일관되게 도착한다면, 앱을 실행한 직후에 실시한 테스트보다 백그라운드 경로가 더 안정적인 것입니다.

어느 부분이 여전히 고장인지 어떻게 알 수 있을까요?

현재 설정을 언제 변경해야 할까요?

기술적으로는 올바른 구성이라도 실제 사용 환경에는 적합하지 않을 수 있습니다. Element의 추적 시스템에는 특정 Matrix 시나리오에서 공용 ntfy 인프라를 포함한 일부 UnifiedPush 엔드포인트가 속도 제한에 걸리는 사례가 기록되어 있습니다. 이로 인해 등록은 ​​올바르게 완료된 것처럼 보이지만 알림이 전송되지 않을 수 있습니다. UnifiedPush 엔드포인트 속도 제한 에 대한 Element의 이슈를 참조하십시오 .

권한, 공급자 선택 및 배터리 설정이 모두 올바른데도 전송이 불안정하다면 다른 UnifiedPush 배포업체를 사용하거나 자체 호스팅 푸시 서버를 사용해 보세요. UnifiedPush는 호스팅 및 자체 호스팅 옵션에 대한 문서를 제공합니다. 이는 Element 데이터를 반복적으로 삭제하는 것보다 전송 과정에서 오류가 발생할 가능성이 가장 높은 부분을 변경하므로 더 효과적인 진단 방법입니다.

자체 호스팅은 더 많은 제어 권한을 제공하지만 운영 책임이 추가됩니다. ntfy의 경우 자체 호스팅 배포를 위해 Matrix 게이트웨이를 올바르게 구성해야 합니다. UnifiedPush ntfy 공식 가이드에 이 요구 사항이 명시되어 있습니다. 테스트 알림이 한 번 지연되었다는 이유만으로 자체 호스팅으로 전환하지 마십시오. 오류가 반복적으로 발생하고 Android 제한 사항이 배제된 경우에만 전환하십시오.

기존 Element 안드로이드 앱은 어떻습니까?

이전 세대 Element Android 애플리케이션은 FCM을 사용하지 않는 동작과 UnifiedPush를 구현했습니다. 공식 문서에는 F-Droid 백그라운드 폴링과 UnifiedPush 지원에 대한 내용이 모두 설명되어 있습니다. 하지만 Element는 이제 신규 사용자에게 Element X를 권장하므로, 특별한 호환성 요구 사항이 없는 한 Element X를 사용하는 것이 더 나은 시작점입니다. 기존 구현 세부 정보는 Android 유휴 모드에서 폴링만으로는 안정성이 떨어지는 이유를 이해하는 데 여전히 유용합니다. Element Android의 UnifiedPush 관련 내용은 보관된/현재 프로젝트 문서를 참조하십시오 .

최종 확인 체크리스트

• Element X에 대한 Android 알림 권한이 활성화되었습니다.
• UnifiedPush 배포기가 설치, 활성화 및 연결되었습니다.
• Element X는 해당 배전기를 사용하도록 구성되어 있습니다.
• 해당 유통업체는 안드로이드의 배터리 제한 모드를 사용하고 있지 않습니다.
• Element가 백그라운드에서 실행 중인 동안 다른 계정에서 메시지가 전송되면 알림이 표시됩니다.
• 휴대전화가 유휴 상태였던 후에도 동일한 테스트가 작동합니다.
• 배송이 계속 실패하는 경우 Matrix 계정을 재설정하기 전에 다른 유통업체 또는 서버를 테스트해 보세요.

모든 안드로이드 빌드에서 즉시 전송을 보장하는 보편적인 설정은 없습니다. 기기 제조사에서 백그라운드 실행에 대한 추가적인 제한을 둘 수 있고, 네트워크 문제로 인해 지속적인 연결이 방해받을 수 있으며, 푸시 알림 엔드포인트가 일시적으로 사용 불가능하거나 전송 속도 제한을 받을 수도 있습니다. 따라서 가장 확실한 결과는 단일 알림 성공이 아니라 여러 백그라운드 및 유휴 테스트에서 반복적으로 안정적인 동작을 보이는 것입니다.