diff --git a/website/docs/guide/faq.md b/website/docs/guide/faq.md index 16af45e48709..066bc0d037ba 100644 --- a/website/docs/guide/faq.md +++ b/website/docs/guide/faq.md @@ -2,13 +2,13 @@ ## Does KernelSU support my device? -KernelSU supports devices running Android with an unlockable bootloader, moreover official support is only for GKI Linux Kernels 5.10+ (in practice this means that your device needs to have Android 12 out of the factory in order to be supported). +KernelSU supports devices running Android with an unlocked bootloader. However, official support is only for GKI Linux Kernels 5.10+ (in practice, this means your device needs to have Android 12 out-of-the-box to be supported). -You can easily check support for your device via the KernelSU Manager, which you can get [here](https://github.com/tiann/KernelSU/releases). +You can easily check the support for your device through the KernelSU manager, which is available [here](https://github.com/tiann/KernelSU/releases). -If it shows `Not Installed`, then your device most likely supports KernelSU officially. +If the app shows `Not installed`, it means your device is officially supported by KernelSU. -If it shows `Unsupported`, then your device is not officially supported at present. However, you can build kernel source and integrate KernelSU to make it work, or use [Unofficially supported devices](unofficially-support-devices). +If the app shows `Unsupported`, it means your device isn't officially supported at present. However, you can build kernel source code and integrate KernelSU to make it work, or use [Unofficially supported devices](unofficially-support-devices). ## Does KernelSU need to unlock bootloader? @@ -16,15 +16,15 @@ Certainly, yes. ## Does KernelSU support modules? -Yes, most Magisk modules work out-of-the-box with KernelSU, check [Module guide](module.md) for more info. +Yes, most Magisk modules work on KernelSU. Check [Module guide](module.md) for more info. ## Does KernelSU support Xposed? -Yes, you can use LSPosed (or other modern XPosed derivative) with [ZygiskNext](https://github.com/Dr-TSNG/ZygiskNext). +Yes, you can use LSPosed (or other modern Xposed derivative) with [ZygiskNext](https://github.com/Dr-TSNG/ZygiskNext). ## Does KernelSU support Zygisk? -KernelSU has no built-in Zygisk support, but you can a module like [ZygiskNext](https://github.com/Dr-TSNG/ZygiskNext) to support it. +KernelSU has no built-in Zygisk support, but you can use a module like [ZygiskNext](https://github.com/Dr-TSNG/ZygiskNext) to support it. ## Is KernelSU compatible with Magisk? diff --git a/website/docs/guide/module.md b/website/docs/guide/module.md index 9fcff84f2610..fa2319394490 100644 --- a/website/docs/guide/module.md +++ b/website/docs/guide/module.md @@ -99,7 +99,7 @@ author= description= ``` -- `id` has to match this regular expression: `^[a-zA-Z][a-zA-Z0-9._-]+$` .
+- `id` has to match this regular expression: `^[a-zA-Z][a-zA-Z0-9._-]+$`
Example: ✓ `a_module`, ✓ `a.module`, ✓ `module-101`, ✗ `a module`, ✗ `1_module`, ✗ `-a-module`
This is the **unique identifier** of your module. You should not change it once published. - `versionCode` has to be an **integer**. This is used to compare versions. @@ -150,7 +150,7 @@ REPLACE=" This list will automatically create the directories `$MODPATH/system/app/YouTube` and `$MODPATH/system/app/Bloatware`, and then execute `setfattr -n trusted.overlay.opaque -v y $MODPATH/system/app/YouTube` and `setfattr -n trusted.overlay.opaque -v y $MODPATH/system/app/Bloatware`. After the module takes effect, `/system/app/YouTube` and `/system/app/Bloatware` will be replaced with empty directories. ::: tip DIFFERENCE WITH MAGISK -KernelSU's systemless mechanism is implemented through the kernel's OverlayFS, while Magisk currently uses magic mount (bind mount). These two implementation methods have significant differences, but the ultimate goal is the same: modifying /system files without physically modifying the /system partition. +KernelSU's systemless mechanism is implemented through the kernel's OverlayFS, while Magisk currently uses magic mount (bind mount). These two implementation methods have significant differences, but the ultimate goal is the same: modifying `/system` files without physically modifying the `/system` partition. ::: If you're interested in OverlayFS, it's recommended to read the Linux Kernel's [documentation on OverlayFS](https://docs.kernel.org/filesystems/overlayfs.html). @@ -250,8 +250,8 @@ In KernelSU, scripts are divided into two types based on their running mode: pos In KernelSU, startup scripts are divided into two types based on their storage location: general scripts and module scripts. - General scripts - - Placed in `/data/adb/post-fs-data.d`, `/data/adb/service.d`, `/data/adb/post-mount.d` or `/data/adb/boot-completed.d.` - - Only executed if the script is set as executable (`chmod +x script.sh`) + - Placed in `/data/adb/post-fs-data.d`, `/data/adb/service.d`, `/data/adb/post-mount.d` or `/data/adb/boot-completed.d`. + - Only executed if the script is set as executable (`chmod +x script.sh`). - Scripts in `post-fs-data.d` runs in post-fs-data mode, and scripts in `service.d` runs in late_start service mode. - Modules should **NOT** add general scripts during installation. - Module scripts diff --git a/website/docs/pt_BR/guide/faq.md b/website/docs/pt_BR/guide/faq.md index c5c229118598..776b9bb2cea7 100644 --- a/website/docs/pt_BR/guide/faq.md +++ b/website/docs/pt_BR/guide/faq.md @@ -2,9 +2,13 @@ ## KernelSU oferece suporte ao meu dispositivo? -Primeiro, seu dispositivo deve ser capaz de desbloquear o bootloader. Se não, então não há suporte. +O KernelSU suporta dispositivos rodando Android com bootloader desbloqueado. No entanto, o suporte oficial é apenas para kernels Linux GKI 5.10+ (na prática isso significa que seu dispositivo precisa ter Android 12 de fábrica para ser compatível). -Em seguida, instale o gerenciador do KernelSU no seu dispositivo e abra-o. Se aparecer `Sem suporte` então seu dispositivo não pode ser suportado imediatamente. No entanto, você pode compilar a fonte do kernel e integrar o KernelSU para fazê-lo funcionar ou usar [Dispositivos com suporte não oficial](unofficially-support-devices). +Você pode verificar facilmente o suporte para o seu dispositivo através do gerenciador do KernelSU, que está disponível [aqui](https://github.com/tiann/KernelSU/releases). + +Se o app mostrar `Não instalado`, significa que seu dispositivo é oficialmente suportado pelo KernelSU. + +Se o app mostrar `Sem suporte`, significa que seu dispositivo não é oficialmente suportado no momento. No entanto, você pode compilar o código-fonte do kernel e integrar o KernelSU para fazê-lo funcionar, ou usar [Dispositivos com suporte não oficial](unofficially-support-devices). ## Para usar o KernelSU precisa desbloquear o bootloader? @@ -12,15 +16,15 @@ Certamente, sim. ## KernelSU suporta módulos? -Sim, verifique [Guias de módulo](module.md). +Sim, a maioria dos módulos Magisk funcionam no KernelSU. Verifique [Guias de módulo](module.md) para mais informações. ## KernelSU suporta Xposed? -Sim, você pode usar LSPosed com [ZygiskNext](https://github.com/Dr-TSNG/ZygiskNext). +Sim, você pode usar LSPosed (ou outro derivado moderno do Xposed) com [ZygiskNext](https://github.com/Dr-TSNG/ZygiskNext). ## KernelSU suporta Zygisk? -KernelSU não tem suporte integrado ao Zygisk, mas você pode usar [ZygiskNext](https://github.com/Dr-TSNG/ZygiskNext). +KernelSU não tem suporte integrado ao Zygisk, mas você pode usar um módulo como [ZygiskNext](https://github.com/Dr-TSNG/ZygiskNext) para suportá-lo. ## KernelSU é compatível com o Magisk? @@ -65,7 +69,7 @@ Não recomendamos que você modifique a partição do sistema diretamente. Por f ## KernelSU pode modificar hosts? Como posso usar AdAway? -Claro. Mas o KernelSU não tem suporte a hosts integrados, você pode instalar [systemless-hosts](https://github.com/symbuzzer/systemless-hosts-KernelSU-module) para fazer isso. +Claro. Mas o KernelSU não tem suporte a hosts integrados, você pode instalar um módulo como [systemless-hosts](https://github.com/symbuzzer/systemless-hosts-KernelSU-module) para fazer isso. ## Por que existe um enorme arquivo de 1 TB? diff --git a/website/docs/pt_BR/guide/module.md b/website/docs/pt_BR/guide/module.md index 1b094962a07b..70950a4dacfc 100644 --- a/website/docs/pt_BR/guide/module.md +++ b/website/docs/pt_BR/guide/module.md @@ -150,7 +150,7 @@ REPLACE=" Esta lista criará automaticamente os diretórios `$MODPATH/system/app/YouTube` e `$MODPATH/system/app/Bloatware` e, em seguida, executará `setfattr -n trusted.overlay.opaque -v y $MODPATH/system/app/YouTube` e `setfattr -n trusted.overlay.opaque -v y $MODPATH/system/app/Bloatware`. Após o módulo entrar em vigor, `/system/app/YouTube` e `/system/app/Bloatware` serão substituídos por diretórios vazios. ::: tip DIFERENÇAS COM MAGISK -O mecanismo sem sistema do KernelSU é implementado através do OverlayFS do kernel, enquanto o Magisk atualmente usa montagem mágica (montagem de ligação). Os dois métodos de implementação têm diferenças significativas, mas o objetivo final é o mesmo: modificar os arquivos /system sem modificar fisicamente a partição /system. +O mecanismo sem sistema do KernelSU é implementado através do OverlayFS do kernel, enquanto o Magisk atualmente usa montagem mágica (montagem de ligação). Os dois métodos de implementação têm diferenças significativas, mas o objetivo final é o mesmo: modificar os arquivos `/system` sem modificar fisicamente a partição `/system`. ::: Se você estiver interessado em OverlayFS, é recomendável ler a [documentação sobre OverlayFS](https://docs.kernel.org/filesystems/overlayfs.html) do kernel Linux. @@ -229,7 +229,7 @@ set_perm_recursive se [context] não está definido, o padrão é "u:object_r:system_file:s0" para todos os arquivos em , ele chamará: set_perm arquivo proprietário do grupo filepermission - para todos os diretórios em (including itself), ele vai ligar: + para todos os diretórios em (incluindo ele mesmo), ele vai ligar: set_perm dir owner group dirpermission context ```