Repository navigation
es 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 | 中文
¡Gracias por ayudar! COPG-VD está pensado para que sea fácil contribuir. Esta guía te dice dónde vive cada cosa y las pocas convenciones que seguimos.
COPG-VD es un spoofer de dispositivo con Zygisk: una pequeña biblioteca nativa que se inyecta en los procesos de las apps para reescribir la huella del dispositivo y el build, más una WebUI en vanilla JS para controlarlo. Es un fork de COPG (de AlirezaParsi), mantenido por VD171 bajo la licencia Apache-2.0. Consulta ARCHITECTURE.md y FILE-STRUCTURE.md.
De forma predeterminada acota el spoof al stack de Google Play mediante Zygisk, así que es una alternativa más ligera y robusta a PlayIntegrityFix.
Los asistentes y agentes de IA son colaboradores de primera clase aquí, no una ocurrencia tardía.
- El proyecto está construido para ser legible: la configuración es un único archivo JSON
(
/data/adb/COPG-VD/COPG-VD.json, documentado en CONFIGURATION.md), los motores son pequeños y autocontenidos, y la disposición está en FILE-STRUCTURE.md. - Los parches asistidos por IA se revisan y aceptan en los mismos términos que cualquier otro: por corrección, claridad y las convenciones de abajo, no por quién (o qué) los escribió.
- El mismo listón para todos: una función real nunca se debilita, el spoof se mantiene coherente, y nada secreto o específico del dispositivo llega al repo (consulta el .gitignore).
- Necesitas un dispositivo rooteado o un emulador con Zygisk (KernelSU, APatch o Magisk) para probar.
- Compila la biblioteca nativa por ABI con el NDK (r29) y CMake: consulta el paso
Build zygisk librariesen.github/workflows/COPG-VD.ymlpara el comando exacto. CI compila las tres ABIs por ti. - Compila un zip flasheable: copia el
libspoof.socompilado enmodule/zygisk/<abi>.so, luegocd module && zip -r9 ../COPG-VD-dev.zip .y flashéalo. - La WebUI es
module/webroot/(ábrela desde el gestor de root). La lógica de spoofing eszygisk/spoof_module.cpp; el obtentor del perfil esmodule/fingerprint-update.sh.
-
Cada archivo fuente del módulo (
.cpp,.sh,.js,.css,.html) empieza con la cabecera de banner del proyecto (cópiala de cualquier archivo existente). Las herramientas bajo.github/usan en su lugar un comentario corto. - Código y comentarios en inglés. Mantén los comentarios al mínimo y solo donde haga falta.
-
Sin em-dash ni en-dash; usa siempre un guion simple
-. - La WebUI es vanilla JS (un solo
scripts.js); sin frameworks. - Nunca debilites una función real: mantén el spoof coherente, y no hagas que los hooks hagan caer una app a la que están adjuntos (tienen comprobación de null a propósito).
- Las cadenas de la UI viven en
module/webroot/lang/. El inglés es el fallback canónico (en.js+en.json); los otros 20 idiomas son<code>.json. - Para añadir o cambiar una cadena: edita
en.jsyen.json, luego actualiza cada<code>.json. Tocar una etiqueta visible significa actualizar todos los archivos de idioma y todos losREADME.<code>.md. - Las traducciones son JSON simple: una gran primera contribución.
- Mantén los PRs enfocados. Describe el qué y el porqué.
- Firma tus commits (DCO):
git commit -s(añadeSigned-off-by:). - CI debe seguir en verde. Sé amable en las revisiones: consulta CODE_OF_CONDUCT.md.
Busca las etiquetas good first issue y help wanted. Las traducciones, la documentación y
los nuevos perfiles de Pixel son todos excelentes puntos de partida.
Esta documentación se generó con Claude (Anthropic) y la mantiene VD171. Las correcciones y mejoras son bienvenidas; consulta CONTRIBUTING.md.