FolkPatch

🌏 README 언어: English / 中文 / 日本語

FolkPatch - 인터페이스 최적화와 기능 확장에 집중한 Root 관리 도구

KernelPatch를 기반으로 구축되어 안정적인 Root 기능을 제공하는 동시에,全新的 인터페이스 경험과 APM / KPM / 플러그인 3계층 확장 체계를 제공합니다. 종합 문서를 통해 빠르게 시작하세요——설치 및 사용, 모듈 관리, 플러그인 개발, 개인화 설정까지 모두 갖추어져 있습니다.

📚 전체 문서 읽기 →

---

✨ 소개

🎨 핵심 기능

• KernelPatch 기반 Root 구현
• 커널을 재컴파일하지 않고 커널 함수를 Hook

📱 사전 요구 사항

• 필수: ARM64 아키텍처 기반이며 Linux 커널 버전 3.18 ~ 6.15인 Android 기기

🎨 관리자의 인터페이스와 디자인

• [x]全新的 UI와 상호작용 경험 최적화
• 개인화 배경화면 지원
• 국제화 지원
• 애니메이션 성능 및 상호작용 유연성 최적화
• 인터페이스 시각적 디테일과 동적 효과 향상
• 자동 업데이트 확인을 수동으로 끌 수 있도록 지원하여 버전 업그레이드의 주도권을 사용자에게 돌려줌

📦 모듈과 확장 체계

FolkPatch는 커널부터 사용자 공간까지 다양한 커스터마이징 요구를 아우르는 3계층 확장 기능을 제공합니다:

• APM: Magisk 유사 모듈 시스템, 일괄 플래싱과 전체 백업 지원
• KPM: 커널 모듈 시스템(inline-hook 및 syscall-table-hook 지원), 자동 로드 지원
• 플러그인(APD Lua Plugin): 경량 Lua 스크립트 확장, APM과 KPM 사이에 위치
• 내장 스토어를 통해 인기 있는 APM, KPM 및 플러그인을 원클릭으로 다운로드

🧩 플러그인 시스템(APD Lua Plugin)

플러그인은 FolkPatch가 독자적으로 개발한 경량 사용자 공간 확장으로, APM(시스템 수준 모듈)과 KPM(커널 수준 모듈) 사이에 위치합니다: 시스템 파일을 수정하지 않고 커널에 주입하지 않으며, apd 라이프사이클에서만 Lua 스크립트를 실행합니다. 기존 모듈과 비교해 플러그인은 설치 즉시 적용되고 재부팅이 필요 없으며 개발 진입 장벽이 더 낮습니다.

지원 기능:

• 시작/중지 스위치와 원클릭 활성화/비활성화
• 빠른 작업(Action)과 사용자 설정 인터페이스
• 예약 데몬 작업(백그라운드 폴링 실행)
• 영구 실행 로그, 조회, 내보내기 및 공유 지원

플러그인의 패키지 형식, API, 라이프사이클 및 관리 명령 등 전체 문서:

• 🇨🇳 중국어: https://fp.mysqil.com/modules/plugin/
• 🇬🇧 English: https://fp.mysqil.com/en/modules/plugin/

⚡ 기술적 특징

• KernelPatch 기반

🚀 다운로드 및 설치

1. 다운로드: 릴리스 페이지에서 최신 버전 설치 패키지를 받으세요

2. 설치: 설치 패키지를 Android 기기에 설치하고 앱 내 안내에 따라 배포를 완료하세요

3. 사용 시작: 전체 문서를 읽고 모듈 관리, 플러그인 개발 등 고급 사용법을 알아보세요

🙏 오픈소스 감사의 글

이 프로젝트는 다음 오픈소스 프로젝트를 기반으로 합니다:

• KernelPatch - 핵심 컴포넌트
• Magisk - magiskpolicy
• KernelSU - 앱 UI 및 Magisk 유사 모듈 지원
• Sukisu-Ultra - 일부 인터페이스 디자인 참고
• APatch - 업스트림 브랜치
• MMRL - 모듈 저장소 데이터 형식 참고 및 데이터 소스
• Shizuku - 내장 Shizuku 서비스

📄 라이선스

• FolkPatch는 GNU General Public License v3 (GPL-3) 라이선스로 오픈소스로 공개됩니다. 2차 수정자 또는 배포자로서 다음 기준을 준수해야 합니다:
• 코드를 수정하거나 프로젝트에 FolkPatch를 통합하여 제3자에게 배포하는 경우, 전체 프로젝트 역시 GPLv3 프로토콜로 오픈소스로 공개해야 합니다
• 바이너리 파일을 배포할 때는 완전하고 읽을 수 있는 소스 코드를 적극적으로 제공하거나 제공할 것을 약속해야 합니다
• 소프트웨어 라이선스 자체에 대해 라이선스 비용을 부과하는 것은 엄격히 금지되며, 배포, 기술 지원 또는 맞춤형 개발에 대해서는 비용을 청구할 수 있습니다
• 배포 행위는 해당 프로젝트와 관련된 귀하의 관련 특허를 모든 사용자에게 사용하도록 허여함을 의미합니다
• 본 소프트웨어는 "있는 그대로" 제공되며 어떠한 보증도 포함하지 않으며, 원저자는 본 소프트웨어 사용으로 인해 발생하는 어떠한 손실에 대해서도 책임지지 않습니다
• 위 조항을 위반하는 모든 행위는 귀하의 GPLv3 라이선스를 자동으로 종료시키며, 이 경우 귀하는 FolkPatch를 배포할 법적 권리를 상실하게 되고, 원저자는 법에 따라 저작권 침해 책임(침해 중지 가처분 신청, 경제적 배상 및 위반 프로젝트 게시 중단 등을 포함하되 이에 국한되지 않음)을 추궁할 권리를 보유합니다

💬 커뮤니티 교류

FolkPatch 토론 및 교류

• Telegram 채널: @FolkPatch