Connexion
KO

Android의 JumPHP runtime: 앱 설치

휴대폰에서는 웹페이지가 사용자 자신의 네트워크(집 Wi-Fi, VPN, 사용자의 주소만 허용하는 서버)에 접근할 수 없습니다. Android용 JumPHP runtime은 브라우저에서 연 JumPHP 앱을 위해 이를 대신해 주는 작은 앱이며, 사용자의 허용이 있을 때만 동작합니다. Google Play에는 없으며 .apk 파일을 직접 설치합니다. 이 페이지는 Android가 체크하라고 요구하는 각 항목을 설명합니다.

Android가 위험할 수 있다고 하나요? 바이러스가 아닙니다

브라우저, Android 또는 Google Play 프로텍트가 이 파일이 „기기에 해를 끼칠 수 있음”, „다운로드 수가 적음” 또는 „출처를 알 수 없음”이라고 표시할 수 있습니다. 이는 정상이며 예상된 동작입니다. 앱이 Google Play로 배포되지 않고 자체 키로 서명되었다는 뜻일 뿐입니다. 확인할 수 있는 것:

  • 소스 코드가 공개되어 있습니다: git.jumphp.net/jumphp/jumPhp (폴더 apps/runtime-android);
  • 휴대폰 자체에서만(127.0.0.1) 대기하고, jumphp.net 페이지에만 응답하며, 사용자가 항상 또는 이번만을 누른 곳에만 연결합니다;
  • 파일, 연락처, 메시지를 절대 읽지 않으며 통과하는 내용을 기록하지 않습니다(기록은 로그뿐: 사이트, 앱, 대상, 시간, 사용량);
  • 언제든지 모든 허용을 취소하거나 앱을 삭제할 수 있습니다;
  • 서명 인증서 지문(SHA-256): D5:4C:E2:69:90:7A:FE:E5:0C:1F:E6:73:70:98:38:DD:15:16:29:CC:B0:35:4C:ED:FB:0F:98:F6:E6:5D:15:AE.

설치 방법

  1. 릴리스 페이지(최신 runtime-android-v…)에서 jumphp-runtime-android.apk를 다운로드합니다. Chrome이 „이 파일 형식은 기기에 해를 끼칠 수 있습니다”라고 물으면 보관(또는 그래도 다운로드)을 누릅니다.
  2. 다운로드한 파일을 엽니다. Android가 „보안을 위해 휴대폰에서 이 출처의 알 수 없는 앱을 설치할 수 없습니다” 라고 하면 설정을 누르고 이 출처 허용을 켭니다(브라우저용, 예: Chrome). 창이 열리지 않으면: 설정 → 앱 → 특별 앱 액세스 → 알 수 없는 앱 설치 → 사용 중인 브라우저 → 허용. 돌아와서 설치를 누릅니다.
  3. Google Play 프로텍트가 „차단됨”, „기기 보호를 위해 앱이 차단되었습니다” 또는 „앱을 검사할까요?” 를 표시하면 세부정보 더보기 → 무시하고 설치(또는 검사 없이 설치)를 누릅니다. Xiaomi에서는 추가 보안 질문이 나올 수 있으니 허용하세요.
  4. JumPHP runtime을 엽니다. Android가 물으면 알림을 허용합니다(Android 13 이상). 질문(„이 앱을 허용할까요?”)은 알림으로 도착합니다.
  5. 저절로 시작됩니다(상태: 켜짐, 알림이 계속 표시됨). 계속 실행을 누르고 배터리는 최적화 안 함 / 제한 없음을 선택해 Android가 중지하지 않게 하세요.
  6. Xiaomi, Huawei, Oppo, Vivo, OnePlus, Samsung 등에서는 **휴대폰과 함께 시작(자동 시작)**도 눌러 켜세요. 그렇지 않으면 재부팅 후 앱이 시작되지 않습니다.
  7. 앱 페이지로 돌아오면 표시등이 주황색이 됩니다. Allow this app을 누르세요. 알림이 „…을(를) 허용할까요?”라고 물으면 눌러서 항상을 선택합니다. 표시등이 초록색이 됩니다.

개발자 모드가 필요한가요?

아니요. 브라우저에서 .apk를 설치하는 데 개발자 옵션과 USB 디버깅은 필요하지 않습니다. 브라우저에 대한 „알 수 없는 앱 설치” 허용(2단계)만 필요하며, 나중에 다시 끌 수 있습니다.

업데이트

앱은 6시간마다(그리고 열 때) 새 버전을 확인합니다. 알림과 설치 버튼이 나타나며, Android가 새 파일이 같은 키로 서명되었는지 확인하고 사용자가 확인하면 끝입니다.

문제 해결

  • 앱이 설치되지 않음: 다른 키로 서명된 이전 사본이 휴대폰에 있습니다. 삭제한 뒤 다시 설치하세요.
  • 재부팅 후 멈춤: 자동 시작(6단계)과 배터리 설정(5단계)을 켜세요.
  • 표시등이 계속 빨간색: 앱을 열고(상태: 켜짐) 페이지를 새로고침하거나, 페이지의 Start / install the app을 누르세요.
  • 질문이 보이지 않음: 앱의 알림을 허용하세요(설정 → 앱 → JumPHP runtime → 알림).

iPhone에서는 불가능합니다(로컬 포트가 있는 백그라운드 서비스가 없음). 앱은 계속 jumphp.net 서버를 통해 연결합니다.

함께 보기: JumPHP runtime.