Repository navigation
pt 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 | 中文
Obrigado por ajudar! O COPG-VD foi feito para ser fácil de contribuir. Este guia diz onde as coisas ficam e as poucas convenções que seguimos.
O COPG-VD é um spoofer de dispositivo Zygisk: uma pequena biblioteca nativa que é injetada nos processos dos apps para reescrever o fingerprint e o build do dispositivo, mais uma WebUI em JS puro para controlá-lo. É um fork do COPG (por AlirezaParsi), mantido por VD171 sob a licença Apache-2.0. Veja ARCHITECTURE.md e FILE-STRUCTURE.md.
Por padrão, ele limita o spoof à stack do Google Play por meio do Zygisk, sendo assim uma alternativa mais leve e robusta ao PlayIntegrityFix.
Assistentes e agentes de IA são contribuidores de primeira classe aqui, não uma reflexão tardia.
- O projeto foi feito para ser legível: a configuração é um único arquivo JSON
(
/data/adb/COPG-VD/COPG-VD.json, documentado em CONFIGURATION.md), os motores são pequenos e autocontidos, e o layout está em FILE-STRUCTURE.md. - Patches assistidos por IA são revisados e aceitos nos mesmos termos de qualquer outro: por correção, clareza e as convenções abaixo, não por quem (ou o quê) os escreveu.
- A mesma régua para todos: uma funcionalidade real nunca é enfraquecida, o spoof permanece coerente, e nada secreto ou específico de dispositivo entra no repositório (veja o .gitignore).
- Você precisa de um dispositivo com root ou emulador com Zygisk (KernelSU, APatch ou Magisk) para testar.
- Compile a biblioteca nativa por ABI com o NDK (r29) e o CMake: veja o passo
Build zygisk librariesem.github/workflows/COPG-VD.ymlpara o comando exato. O CI compila todas as três ABIs para você. - Compile um zip flashável: copie o
libspoof.socompilado paramodule/zygisk/<abi>.so, depoiscd module && zip -r9 ../COPG-VD-dev.zip .e faça o flash. - A WebUI é
module/webroot/(abra pelo gerenciador de root). A lógica de spoofing ézygisk/spoof_module.cpp; o buscador de perfil émodule/fingerprint-update.sh.
-
Todo arquivo-fonte do módulo (
.cpp,.sh,.js,.css,.html) começa com o cabeçalho de banner do projeto (copie-o de qualquer arquivo existente). O ferramental em.github/usa um comentário curto no lugar. - Código e comentários em inglês. Mantenha os comentários mínimos e só onde necessário.
-
Sem em-dash nem en-dash; sempre use um hífen simples
-. - A WebUI é JS puro (um único
scripts.js); sem frameworks. - Nunca enfraqueça uma funcionalidade real: mantenha o spoof coerente e não faça os hooks travarem um app ao qual estão anexados (eles têm checagem de null de propósito).
- As strings de UI ficam em
module/webroot/lang/. O inglês é o fallback canônico (en.js+en.json); os outros 20 idiomas são<code>.json. - Para adicionar ou alterar uma string: edite
en.jseen.json, depois atualize cada<code>.json. Mexer em um rótulo visível significa atualizar todos os arquivos de idioma e todos osREADME.<code>.md. - As traduções são JSON puro: uma ótima primeira contribuição.
- Mantenha os PRs focados. Descreva o quê e o porquê.
- Assine seus commits (DCO):
git commit -s(adicionaSigned-off-by:). - O CI precisa continuar verde. Seja gentil nas revisões: veja CODE_OF_CONDUCT.md.
Procure as labels good first issue e help wanted. Traduções, docs e novos
perfis Pixel são ótimos pontos de partida.
Esta documentação foi gerada com o Claude (Anthropic) e é mantida por VD171. Correções e melhorias são bem-vindas; veja CONTRIBUTING.md.