README.md

ByteHide Shield for JVM

Enterprise-grade code protection for Java, Kotlin and Android applications.

Shield applies multiple layers of obfuscation and hardening transformations directly to your compiled bytecode, making reverse engineering significantly more difficult without affecting runtime performance.

Protections

Protection	Description
String Encryption	Encrypts string literals and decrypts them at runtime, preventing static analysis of sensitive text
Control Flow Obfuscation	Restructures method control flow with opaque predicates and matrix-based flattening
Name Obfuscation	Renames classes, methods and fields to meaningless short identifiers
Constant Mutation	Transforms numeric constants into computed arithmetic expressions
Debug Info Removal	Strips source file names, line numbers and local variable tables
Anti-Debug	Detects and prevents debugger attachment at runtime
Anti-Tamper	Validates bytecode integrity to detect unauthorized modifications
Reference Proxy	Replaces direct method and field references with proxy indirections
Resource Protection	Protects embedded resource files from extraction and analysis

Installation

Gradle Plugin

Add to your build.gradle.kts:

plugins {
    id("com.bytehide.shield") version "1.1.3"
}

shield {
    token = "your-project-token"
}

Or in build.gradle (Groovy):

plugins {
    id 'com.bytehide.shield' version '1.1.3'
}

shield {
    token = 'your-project-token'
}

Standalone CLI

curl -fsSL https://repo1.maven.org/maven2/com/bytehide/shield/shield-java-cli/1.1.3/shield-java-cli-1.1.3.jar -o shield-cli.jar
java -jar shield-cli.jar -c config.json

Configuration

Shield can be configured through the Gradle DSL or a JSON configuration file:

shield {
    token = "your-project-token"

    protections {
        stringEncryption = true
        controlFlowObfuscation = true
        nameObfuscation = true
        constantMutation = true
        debugInfoRemoval = true
        antiDebug = true
        antiTamper = true
        referenceProxy = true
        resourceProtection = true
    }

    exclude(
        "com.example.models",                // exclude package from all protections
        "com.example.api:StringEncryption"   // exclude from specific protection
    )
}

Platform Support

• Java 11+
• Kotlin (JVM target)
• Android (via Gradle plugin with AGP 8.x+)
• Gradle 8.x / 9.x

Documentation

Full documentation, guides and API reference available at docs.bytehide.com.

License

Proprietary. See Terms of Service.

---

Built by ByteHide