Skip to content
This repository has been archived by the owner on Apr 15, 2024. It is now read-only.

Commit

Permalink
feat: Improve command line argument descriptions
Browse files Browse the repository at this point in the history
  • Loading branch information
oSumAtrIX committed Jul 30, 2023
1 parent 0a758d8 commit f9cf7d2
Show file tree
Hide file tree
Showing 2 changed files with 34 additions and 25 deletions.
53 changes: 31 additions & 22 deletions src/main/kotlin/app/revanced/cli/command/MainCommand.kt
Original file line number Diff line number Diff line change
Expand Up @@ -32,7 +32,7 @@ private class CLIVersionProvider : IVersionProvider {
}

@Command(
name = "ReVanced-CLI",
name = "ReVanced CLI",
mixinStandardHelpOptions = true,
versionProvider = CLIVersionProvider::class
)
Expand All @@ -44,15 +44,15 @@ internal object MainCommand : Runnable {

class Args {
// TODO: Move this so it is not required when listing patches
@Option(names = ["-a", "--apk"], description = ["Input APK file to be patched"], required = true)
@Option(names = ["-a", "--apk"], description = ["APK file to be patched"], required = true)
lateinit var inputFile: File

@Option(names = ["--uninstall"], description = ["Uninstall the mount variant"])
var uninstall: Boolean = false
@Option(names = ["--unmount"], description = ["Unmount a patched APK file"])
var unmount: Boolean = false

@Option(
names = ["-d", "--deploy-on"],
description = ["If specified, deploy to device over ADB with given name"]
names = ["-d", "--deploy"],
description = ["Deploy to the specified device that is connected via ADB"]
)
var deploy: String? = null

Expand All @@ -78,63 +78,72 @@ internal object MainCommand : Runnable {
@Option(names = ["-l", "--list"], description = ["List patches"], required = true)
var listOnly: Boolean = false

@Option(names = ["--with-versions"], description = ["List patches with compatible versions"])
@Option(names = ["--with-versions"], description = ["List patches with version compatibilities"])
var withVersions: Boolean = false

@Option(names = ["--with-packages"], description = ["List patches with compatible packages"])
@Option(names = ["--with-packages"], description = ["List patches with package compatibilities"])
var withPackages: Boolean = false
}

class PatchingArgs {
@Option(names = ["-o", "--out"], description = ["Output file path"], required = true)
@Option(names = ["-o", "--out"], description = ["Path to save the patched APK file to"], required = true)
lateinit var outputPath: String

@Option(names = ["-e", "--exclude"], description = ["Explicitly exclude patches"])
@Option(names = ["-e", "--exclude"], description = ["Exclude patches"])
var excludedPatches = arrayOf<String>()

@Option(
names = ["--exclusive"],
description = ["Only installs the patches you include, not including any patch by default"]
description = ["Only include patches that were explicitly specified to be included"]
)
var exclusive = false

@Option(names = ["-i", "--include"], description = ["Include patches"])
var includedPatches = arrayOf<String>()

@Option(names = ["--experimental"], description = ["Disable patch version compatibility patch"])
@Option(names = ["--experimental"], description = ["Ignore patches incompatibility to versions"])
var experimental: Boolean = false

@Option(names = ["-m", "--merge"], description = ["One or more dex file containers to merge"])
@Option(names = ["-m", "--merge"], description = ["One or more DEX files or containers to merge into the APK"])
var mergeFiles = listOf<File>()

@Option(names = ["--mount"], description = ["If specified, instead of installing, mount"])
@Option(
names = ["--mount"],
description = ["Mount the patched APK file over the original file instead of installing it"]
)
var mount: Boolean = false

@Option(names = ["--cn"], description = ["Overwrite the default CN for the signed file"])
@Option(names = ["--cn"], description = ["The common name of the signer of the patched APK file"])
var cn = "ReVanced"

@Option(names = ["--keystore"], description = ["File path to your keystore"])
@Option(names = ["--keystore"], description = ["Path to the keystore to sign the patched APK file with"])
var keystorePath: String? = null

@Option(names = ["-p", "--password"], description = ["Overwrite the default password for the signed file"])
@Option(
names = ["-p", "--password"],
description = ["The password of the keystore to sign the patched APK file with"]
)
var password = "ReVanced"

@Option(names = ["-t", "--temp-dir"], description = ["Temporary resource cache directory"])
@Option(names = ["-t", "--temp-dir"], description = ["Path to temporary resource cache directory"])
var cacheDirectory = "revanced-cache"

@Option(
names = ["-c", "--clean"],
description = ["Clean the temporary resource cache directory. This will be done anyways when running the patcher"]
description = ["Clean up the temporary resource cache directory after patching"]
)
var clean: Boolean = false

@Option(names = ["--custom-aapt2-binary"], description = ["Path to custom aapt2 binary"])
@Option(
names = ["--custom-aapt2-binary"],
description = ["Path to custom AAPT binary to compile resources with"]
)
var aaptPath: String = ""
}

override fun run() {
if (args.patchArgs?.listingArgs?.listOnly == true) return printListOfPatches()
if (args.uninstall) return uninstall()
if (args.unmount) return unmount()

val pArgs = this.args.patchArgs?.patchingArgs ?: return
val outputFile = File(pArgs.outputPath) // the file to write to
Expand Down Expand Up @@ -215,7 +224,7 @@ internal object MainCommand : Runnable {
logger.info(result)
}

private fun uninstall() {
private fun unmount() {
val adb: Adb? = args.deploy?.let {
Adb(
File("placeholder_file"),
Expand Down
6 changes: 3 additions & 3 deletions src/main/kotlin/app/revanced/utils/adb/Adb.kt
Original file line number Diff line number Diff line change
Expand Up @@ -11,7 +11,7 @@ internal class Adb(
private val file: File,
private val packageName: String,
deviceName: String,
private val modeInstall: Boolean = false,
private val install: Boolean = false,
private val logging: Boolean = true
) {
private val device: JadbDevice
Expand All @@ -20,7 +20,7 @@ internal class Adb(
device = JadbConnection().devices.let { device -> device.find { it.serial == deviceName } ?: device.first() }
?: throw IllegalArgumentException("No such device with name $deviceName")

if (!modeInstall && device.run("su -h", false) != 0)
if (!install && device.run("su -h", false) != 0)
throw IllegalArgumentException("Root required on $deviceName. Task failed")
}

Expand All @@ -29,7 +29,7 @@ internal class Adb(
}

internal fun deploy() {
if (modeInstall) {
if (install) {
logger.info("Installing without mounting")

PackageManager(device).install(file)
Expand Down

0 comments on commit f9cf7d2

Please sign in to comment.