설치와 시작
공식 릴리스의 메인 APK를 설치하고 Android에서 새글을 켭니다.
어떤 파일을 내려받아야 하나요?
GitHub Releases에서 net.chanpaca.saegeul로 시작하는 최신 사용자 앱 APK 하나를 내려받으면 됩니다. 한글 플러그인 APK는 이전 배포 호환과 독립 검증용 선택 파일입니다.
한글 플러그인을 따로 설치해야 하나요?
아니요. 최신 새글 메인 앱에는 libhangul C 엔진과 한글 입력 설정이 함께 들어 있습니다. 이전 버전에서 플러그인을 설치했다면 최신 메인 앱으로 업데이트한 뒤 별도 플러그인은 제거해도 됩니다.
설치 시 "출처를 알 수 없는 앱" 또는 "안전하지 않은 앱" 경고가 뜹니다
Google Play Store 외부에서 APK를 직접 내려받았을 때 Google Play Protect가 아직 등록되지 않은 서명으로 인식하여 표시하는 표준 안내입니다. 앱 자체의 결함이나 악성코드가 아닙니다.
공식 GitHub Releases가 아닌 곳에서 받은 파일은 설치하지 마세요. 설치가 차단되면 Play Protect를 끄지 말고, 릴리스의 SHA-256 체크섬과 아래 GitHub 직접 배포 APK 서명 지문이 일치하는지 먼저 확인하세요.
Google Play에서 설치한 앱은 Play가 별도 앱 서명 키로 다시 서명하므로 GitHub APK와 지문이 다릅니다.
배포 채널별 공식 서명 인증서 지문(SHA-256)
GitHub 직접 배포 APK와 호환·검증용 한글 플러그인 APK는 새글 업로드/릴리스 키로 서명됩니다.
3B:08:8B:5C:6A:69:E3:6C:62:80:2E:F5:D4:33:BD:9D:84:5B:8E:98:09:27:8E:13:13:36:A5:03:DA:90:1A:66
Google Play 설치본은 Play App Signing 키로 서명됩니다.
9F:22:43:69:28:D5:DC:AE:08:EF:26:57:DF:D7:C3:AB:88:F6:B7:E3:04:8F:B7:1D:2D:41:E9:C2:25:6F:E9:11
Android SDK 터미널에서 apksigner verify --verbose --print-certs 파일명.apk 명령으로 설치 경로에 맞는 지문과 v1/v2/v3 서명을 직접 검증할 수 있습니다.
특정 게임이나 웹뷰 앱에서 한글 조합이 깨질 때의 대처법
일부 앱은 한글 조합 중인 중간 버퍼(Composing Text)를 정상 처리하지 못합니다. 설정 > 고급 > 한글 버퍼 호환 모드를 켜면 키보드 내부에서 글자를 완성한 후 한 덩어리로 전달합니다. 시스템 붙여넣기, Ctrl+V, 직접 확정 방식 중 선택할 수 있습니다.
기기 안 AI, 새글 AI
Google Gemma를 내 휴대폰 안에서만 실행합니다. 입력한 글은 어디로도 보내지 않습니다.
새글 AI 모델(Google Gemma 4 E2B, 약 2.6GB)을 한 번 받아 두면, 그다음부터는 인터넷이 없어도 쓸 수 있습니다. 서버로 보내는 글쓰기 API가 없고, PC와 연결하는 절차도 없습니다.
새글 AI는 어떻게 설치하나요?
1. 새글 앱의 개인정보·AI > 새글 AI에서 설치를 시작합니다.
2. 모바일 데이터로 연결돼 있으면 와이파이로 받을지, 지금 데이터로 받을지 먼저 확인합니다. 약 2.6GB이므로 와이파이를 권장합니다.
3. 받은 파일은 무결성을 검증한 뒤 설치를 마칩니다. 완전 오프라인 모드에서는 새로 받을 수 없습니다.
입력하는 글이 밖으로 나가지 않나요?
네. 새글 AI는 기기 안에서만 실행되며, 문장을 추천하기 위해 참고하는 문맥도 이 휴대폰을 벗어나지 않습니다. 비밀번호 입력란과 완전 오프라인 모드에서는 AI 기능이 완전히 차단됩니다.
모델을 지우면 어떻게 되나요?
개인정보·AI > 새글 AI > 모델 삭제로 언제든 지울 수 있습니다. 지우면 AI 추천과 이어쓰기가 멈추지만, 그동안 배운 말투 데이터는 남습니다. 다시 설치하면 이어서 씁니다.
테마 & 시각 효과 (Theme v3.0)
초정밀 개별 키 커스텀부터 하드웨어 가속 RGB 셰이더와 터치 별빛 피직스까지 지원합니다.
키 하나하나의 배경색과 글자색을 다르게 지정할 수 있나요?
네! 새글 테마 v3.0 엔진은 개별 키 스타일 상속 체계를 지원합니다. 스페이스바, 엔터키, 백스페이스, 쉬프트키 또는 특정 문자키마다 개별 배경색, 텍스트 색상, 모서리 라운딩 반경, 테두리 두께를 자유롭게 지정할 수 있으며, 지정하지 않은 키는 상위 전역 키 스타일 및 기본 테마 색상을 자동으로 상속받습니다.
9-Patch 슬라이스(Sliced) 키캡 이미지는 어떻게 적용하나요?
커스텀 테마 스튜디오에서 원하는 키캡 비트맵 이미지를 지정하고 4방향 슬라이스 마진(좌, 상, 우, 하)을 설정하면 SlicedKeyDrawable 엔진이 런타임에 3x3 분할 격자로 연산합니다. 모서리 왜곡 없이 키 크기에 맞춰 완벽하게 스트레칭 렌더링됩니다.
RGB 크로마 백라이트나 터치 별빛 파티클을 켜면 배터리가 많이 소모되지 않나요?
전혀 걱정하지 않으셔도 됩니다! 새글의 RGB 크로마 백라이트는 Android 하드웨어 가속 LinearGradient/SweepGradient 셰이더 매트릭스 변환으로 연산되며, 터치 별빛 파티클은 VSYNC 싱크 Choreographer.postFrameCallback과 객체 풀링 기법으로 구동됩니다. 특히 키보드가 닫히거나 타이핑이 멈추면 애니메이션과 프레임 콜백이 즉각 완전 일시정지(Zero-CPU/GPU Idle)되도록 철저히 최적화되어 있습니다.
내가 만든 커스텀 테마를 백업하거나 친구에게 공유할 수 있나요?
네. 설정 > 테마에서 내가 만든 테마를 ZIP 아카이브 파일로 손쉽게 내보내거나 가져올 수 있습니다. 이전 버전(v1.0, v2.0, v2.1)에서 작성된 테마 파일도 최신 v3.0 스키마로 데이터 손실 없이 자동 마이그레이션됩니다.
음성, GIF, OCR
필요할 때만 켜고, 데이터 전송 위치를 사용자가 완전히 제어합니다.
음성 입력 시 데이터가 외부로 나가나요?
기본 휴대폰 받아쓰기는 기기 내장 음성 인식기로 동작하며 외부 전송이 없습니다. 사용자가 정밀 받아쓰기 모드에서 OpenAI STT API 키를 직접 지정한 경우에만 해당 오디오 청크가 전송됩니다.
사진 속 글자 읽기(OCR)는 사진을 서버로 보내나요?
아닙니다. OCR은 기기 안에서 Tesseract/ONNX 로컬 모델을 통해 100% 온디바이스로 처리됩니다. 선택한 사진이나 인식된 텍스트는 네트워크로 전송되지 않습니다.
GIF 검색 시 어떤 정보가 전달되나요?
Animated Noto Emoji는 기기 내에서 키워드를 매칭합니다. KLIPY, GIPHY, Wikimedia를 선택했을 때만 사용자가 입력한 검색어가 해당 미디어 공급자에게 전송됩니다.
개인정보와 데이터
평소 입력은 100% 로컬에서 처리하며 추적 코드가 없습니다.
내가 타이핑하는 키 입력이 개발자 서버로 전송되나요?
절대 전송되지 않습니다. 일반 키 입력은 기기 안에서만 처리됩니다. 개발자 운영 서버와 사용자 계정 시스템은 없습니다. Google AdMob 전면 광고는 언어 지문 「지금 즉시 분석 및 동기화」를 누른 뒤에만 나올 수 있으며, 타이핑 원문을 광고에 보내지 않습니다.
네트워크 기능을 완전히 차단하는 방법이 있나요?
개인정보·AI 설정에서 전체 오프라인 모드를 켜면 AI, 음성 전사, 네트워크 GIF, OCR 모델 다운로드가 하드웨어 레벨에서 일괄 차단되며, 통신량이 0바이트로 유지됩니다.
소스와 문제 해결
공개된 소스 코드와 이슈 트래커를 통해 언제든 확인하고 기여할 수 있습니다.
버그 신고나 기능 제안은 어디에 하나요?
새글 GitHub Issues에 문의를 남겨주세요. 보안 취약점 제보는 yunchan@chanpaca.net로 보내주시기 바랍니다.