Repository navigation
vi CONTRIBUTING
Languages: English | العربية | Čeština | Deutsch | Español | فارسی | Français | हिन्दी | Bahasa Indonesia | Italiano | 日本語 | 한국어 | Nederlands | Polski | Português | Русский | Svenska | ไทย | Türkçe | Українська | Tiếng Việt | 中文
Cảm ơn bạn đã giúp đỡ! COPG-VD được thiết kế để dễ đóng góp. Hướng dẫn này cho bạn biết mọi thứ nằm ở đâu và vài quy ước mà chúng tôi tuân theo.
COPG-VD là một trình giả mạo thiết bị Zygisk (Zygisk device spoofer): một thư viện native nhỏ được tiêm vào các tiến trình ứng dụng để viết lại dấu vân tay và build của thiết bị, cộng với một WebUI thuần JS (vanilla-JS) để điều khiển nó. Nó là một fork của COPG (bởi AlirezaParsi), được duy trì bởi VD171 theo giấy phép Apache-2.0. Xem ARCHITECTURE.md và FILE-STRUCTURE.md.
Theo mặc định, nó giới hạn sự giả mạo vào ngăn xếp Google Play thông qua Zygisk, nên nó là một lựa chọn thay thế nhẹ hơn, mạnh mẽ hơn cho PlayIntegrityFix.
Các trợ lý và tác nhân AI là những người đóng góp hạng nhất ở đây, không phải điều được nghĩ đến sau cùng.
- Dự án được xây dựng để dễ đọc: cấu hình là một tệp JSON duy nhất
(
/data/adb/COPG-VD/COPG-VD.json, được tài liệu hóa trong CONFIGURATION.md), các động cơ nhỏ và tự chứa, và bố cục nằm trong FILE-STRUCTURE.md. - Các bản vá có hỗ trợ AI được xem xét và chấp nhận theo cùng điều kiện như bất kỳ bản vá nào khác: theo tính đúng đắn, sự rõ ràng và các quy ước bên dưới, chứ không theo ai (hay cái gì) đã viết chúng.
- Cùng một tiêu chuẩn cho mọi người: một tính năng thật không bao giờ bị làm yếu đi, sự giả mạo vẫn nhất quán, và không gì bí mật hay dành riêng cho thiết bị lọt vào repo (xem .gitignore).
- Bạn cần một thiết bị đã root hoặc máy ảo có Zygisk (KernelSU, APatch hoặc Magisk) để kiểm thử.
- Build thư viện native theo từng ABI với NDK (r29) và CMake: xem bước
Build zygisk librariestrong.github/workflows/COPG-VD.ymlđể biết lệnh chính xác. CI build cả ba ABI cho bạn. - Build một tệp zip có thể flash: sao chép
libspoof.sođã build vàomodule/zygisk/<abi>.so, sau đócd module && zip -r9 ../COPG-VD-dev.zip .và flash nó. - WebUI là
module/webroot/(mở nó từ trình quản lý root). Logic giả mạo làzygisk/spoof_module.cpp; trình tải hồ sơ làmodule/fingerprint-update.sh.
-
Mọi tệp mã nguồn của mô-đun (
.cpp,.sh,.js,.css,.html) bắt đầu bằng phần đầu banner của dự án (sao chép nó từ bất kỳ tệp hiện có nào). Các công cụ dưới.github/dùng một chú thích ngắn thay thế. - Mã và chú thích bằng tiếng Anh. Giữ chú thích ở mức tối thiểu và chỉ ở nơi cần thiết.
-
Không em-dash hay en-dash; luôn dùng dấu gạch nối thường
-. - WebUI là vanilla JS (một
scripts.jsduy nhất); không framework. - Không bao giờ làm yếu đi một tính năng thật: giữ sự giả mạo nhất quán, và đừng làm các hook làm sập một ứng dụng mà chúng gắn vào (chúng được kiểm tra null một cách có chủ đích).
- Các chuỗi UI nằm trong
module/webroot/lang/. Tiếng Anh là bản dự phòng chuẩn (en.js+en.json); 20 ngôn ngữ còn lại là<code>.json. - Để thêm hoặc thay đổi một chuỗi: chỉnh sửa
en.jsvàen.json, sau đó cập nhật mọi<code>.json. Chạm vào một nhãn hiển thị nghĩa là cập nhật tất cả các tệp ngôn ngữ và tất cảREADME.<code>.md. - Các bản dịch là JSON thuần: một đóng góp đầu tiên tuyệt vời.
- Giữ các PR tập trung. Mô tả cái gì và tại sao.
- Ký xác nhận các commit của bạn (DCO):
git commit -s(thêmSigned-off-by:). - CI phải giữ màu xanh. Hãy tử tế trong các lần review: xem CODE_OF_CONDUCT.md.
Tìm các nhãn good first issue và help wanted. Dịch thuật, tài liệu và các hồ sơ Pixel
mới đều là những điểm khởi đầu tuyệt vời.
Tài liệu này được tạo bằng Claude (Anthropic) và được duy trì bởi VD171. Chúng tôi hoan nghênh các chỉnh sửa và cải tiến; xem CONTRIBUTING.md.