chore(release): 4.4.0 [skip ci]

# [4.4.0](https://github.com/ReVanced/revanced-cli/compare/v4.3.0...v4.4.0) (2023-12-28)

### Bug Fixes

* Add missing punctuation in command description ([8210351](821035107d))

### Features

* Log saved patched APK file path ([16109bd](16109bd8bc))

CHANGELOG.md

@@ -1,3 +1,57 @@
+# [4.4.0](https://github.com/ReVanced/revanced-cli/compare/v4.3.0...v4.4.0) (2023-12-28)
+
+
+### Bug Fixes
+
+* Add missing punctuation in command description ([8210351](https://github.com/ReVanced/revanced-cli/commit/821035107d7264580275f395e9e3fcef91394afd))
+
+
+### Features
+
+* Log saved patched APK file path ([16109bd](https://github.com/ReVanced/revanced-cli/commit/16109bd8bc6236debf71cbc8db78fe452b2ed00d))
+
+# [4.4.0-dev.2](https://github.com/ReVanced/revanced-cli/compare/v4.4.0-dev.1...v4.4.0-dev.2) (2023-12-18)
+
+
+### Bug Fixes
+
+* Add missing punctuation in command description ([8210351](https://github.com/ReVanced/revanced-cli/commit/821035107d7264580275f395e9e3fcef91394afd))
+
+# [4.4.0-dev.1](https://github.com/ReVanced/revanced-cli/compare/v4.3.0...v4.4.0-dev.1) (2023-12-01)
+
+
+### Features
+
+* Log saved patched APK file path ([16109bd](https://github.com/ReVanced/revanced-cli/commit/16109bd8bc6236debf71cbc8db78fe452b2ed00d))
+
+# [4.3.0](https://github.com/ReVanced/revanced-cli/compare/v4.2.0...v4.3.0) (2023-12-01)
+
+
+### Features
+
+* Add `list-versions` command ([a974b8e](https://github.com/ReVanced/revanced-cli/commit/a974b8ea80acd85f8dc472a3f93b8fd7bea08007))
+
+# [4.3.0-dev.1](https://github.com/ReVanced/revanced-cli/compare/v4.2.0...v4.3.0-dev.1) (2023-11-27)
+
+
+### Features
+
+* Add `list-versions` command ([a974b8e](https://github.com/ReVanced/revanced-cli/commit/a974b8ea80acd85f8dc472a3f93b8fd7bea08007))
+
+# [4.2.0](https://github.com/ReVanced/revanced-cli/compare/v4.1.0...v4.2.0) (2023-11-26)
+
+
+### Bug Fixes
+
+* Fix typo ([#300](https://github.com/ReVanced/revanced-cli/issues/300)) ([9d96bb7](https://github.com/ReVanced/revanced-cli/commit/9d96bb7b4cc4538da416db50bd689af1a632fc45))
+
+
+### Features
+
+* Allow selecting first Adb device, if none supplied automatically by updating dependencies ([e7c3d64](https://github.com/ReVanced/revanced-cli/commit/e7c3d64bf15bf84f3853e7ef699511bf72c13767))
+* Exit application with CLI exit code ([36c6a6a](https://github.com/ReVanced/revanced-cli/commit/36c6a6a5f75f2e770a7941b3f83f430f62de13de))
+* Make `--out´ option optional ([3765957](https://github.com/ReVanced/revanced-cli/commit/3765957043989fe7a8932a0c548566a78d04fc41))
+
 # [4.2.0-dev.1](https://github.com/ReVanced/revanced-cli/compare/v4.1.1-dev.1...v4.2.0-dev.1) (2023-11-26)
 
 

docs/0_prerequisites.md

@@ -4,8 +4,8 @@ To use ReVanced CLI, you will need to fulfill specific requirements.
 
 ## 🤝 Requirements
 
-- Java SDK 11 (Azul Zulu JDK or OpenJDK)
-- [Android Debug Bridge (adb)](https://developer.android.com/studio/command-line/adb) if you want to install the patched APK file on your device
+- Java Runtime Environment 11 (Azul Zulu JRE or OpenJDK)
+- [Android Debug Bridge (ADB)](https://developer.android.com/studio/command-line/adb) if you want to install the patched APK file on your device
 - An ABI other than ARMv7 such as x86 or x86-64 (or a custom AAPT binary that supports ARMv7)
 
 ## ⏭️ Whats next

docs/1_usage.md

@@ -34,39 +34,39 @@ ReVanced CLI is divided into the following fundamental commands:
    revanced-patches.jar [<patch-bundle> ...]
   ```
 
-  > [!NOTE]  
-  > A default `options.json` file will be automatically created, if it does not exist 
-  without any need for intervention when using the `patch` command.
+> [!NOTE]  
+> A default `options.json` file will be automatically created if it does not exist 
+without any need for intervention when using the `patch` command.
 
 - ### 💉 Patch an app
 
   You can patch apps by supplying patch bundles and the app to patch.
   After patching, ReVanced CLI can install the patched app on your device using two methods:
 
-  > [!NOTE]  
-  > For ReVanced CLI to be able to install the patched app on your device, make sure ADB is working:
-  >
-  > ```bash
-  > adb shell exit
-  > ```
-  >
-  > To get your device's serial, run the following command:
-  >
-  > ```bash
-  > adb devices
-  > ```
-  >
-  > If you want to mount the patched app on top of the un-patched app, make sure you have root permissions:
-  >
-  > ```bash
-  > adb shell su -c exit
-  > ```
-  >
+> [!NOTE]  
+> For ReVanced CLI to be able to install the patched app on your device, make sure ADB is working:
+>
+> ```bash
+> adb shell exit
+> ```
+>
+> To get your device's serial, run the following command:
+>
+> ```bash
+> adb devices
+> ```
+>
+> If you want to mount the patched app on top of the un-patched app, make sure you have root permissions:
+>
+> ```bash
+> adb shell su -c exit
+> ```
+>
 
-  > [!WARNING]  
-  > Some patches may require integrations
-  > such as [ReVanced Integrations](https://github.com/revanced/revanced-integrations).
-  > Supply them with the option `--merge`. ReVanced Patcher will automatically determine if they are necessary.
+> [!WARNING]  
+> Some patches may require integrations
+> such as [ReVanced Integrations](https://github.com/revanced/revanced-integrations).
+> Supply them with the option `--merge`. ReVanced Patcher will automatically determine if they are necessary.
 
   - #### 👾 Patch an app and install it on your device regularly
 
@@ -79,26 +79,26 @@ ReVanced CLI is divided into the following fundamental commands:
 
   - #### 👾 Patch an app and mount it on top of the un-patched app with root permissions
   
-    > [!IMPORTANT]  
-    > Ensure sure the same app you are patching and mounting over is installed on your device:
-    > 
-    > ```bash
-    > adb install app.apk
-    > ```
+  > [!IMPORTANT]  
+  > Ensure that the same app you are patching and mounting over is installed on your device:
+  > 
+  > ```bash
+  > adb install app.apk
+  > ```
 
-    > [!NOTE]  
-    > You can use the option `--ii` to include or `--ie` to exclude
-    > patches by their index in relation to supplied patch bundles,
-    > similarly to the option `--include` and `--exclude`.
-    > 
-    > This is useful in case two patches have the same name, and you need to include or exclude one of them.  
-    > The index of a patch is calculated by the position of the patch in the list of patches
-    > from patch bundles supplied using the option `--patch-bundle`.
-    > 
-    > You can list all patches with their indices using the command `list-patches`.
-    > 
-    > Keep in mind, that the indices can change based on the order of the patch bundles supplied,
-    > as well if the patch bundles are updated, because patches can be added or removed.
+  > [!NOTE]  
+  > You can use the option `--ii` to include or `--ie` to exclude
+  > patches by their index in relation to supplied patch bundles,
+  > similarly to the option `--include` and `--exclude`.
+  > 
+  > This is useful in case two patches have the same name, and you must include or exclude one.  
+  > The patch index is calculated by the position of the patch in the list of patches
+  > from patch bundles supplied using the option `--patch-bundle`.
+  > 
+  > You can list all patches with their indices using the command `list-patches`.
+  > 
+  > Keep in mind that the indices can change based on the order of the patch bundles supplied,
+  > as well if the patch bundles are updated because patches can be added or removed.
 
     ```bash
     java -jar revanced-cli.jar patch \
@@ -119,9 +119,9 @@ ReVanced CLI is divided into the following fundamental commands:
    [<device-serial>]
   ```
 
-  > [!NOTE]  
-  > You can unmount an APK file
-  by adding the option `--unmount`.
+> [!NOTE]  
+> You can unmount an APK file
+by adding the option `--unmount`.
 
 - ### ️ 📦 Install an app
 
@@ -131,6 +131,6 @@ ReVanced CLI is divided into the following fundamental commands:
    [<device-serial>]
   ```
 
-  > [!NOTE]  
-  > You can mount an APK file 
-  > by supplying the package name of the app to mount the supplied APK file to over the option `--mount`.
+> [!NOTE]  
+> You can mount an APK file 
+> by supplying the package name of the app to mount the supplied APK file over the option `--mount`.

docs/2_building.md

@@ -0,0 +1,26 @@
+# 🔨️ Building
+
+Build ReVanced CLI from source.
+
+## 📝 Requirements
+
+- Java Development Kit 11 (Azul Zulu JRE or OpenJDK)
+
+## 🏗️ Building
+
+To build ReVanced CLI, follow these steps:
+
+1. Clone the repository:
+
+   ```bash
+   git clone git@github.com:ReVanced/revanced-cli.git
+   cd revanced-cli
+   ```
+
+2. Build the project:
+
+   ```bash
+    ./gradlew build
+    ```
+
+After the build succeeds, the built JAR file will be located at `build/libs/revanced-cli-<version>-all.jar`.

docs/README.md

@@ -1,8 +1,9 @@
 # 💻 Documentation and guides of ReVanced CLI
 
-This documentation explains how to use [ReVanced CLI](https://github.com/revanced/revanced-cli).
+This documentation contains topics around [ReVanced CLI](https://github.com/revanced/revanced-cli).
 
 ## 📖 Table of contents
 
 1. [💼 Prerequisites](0_prerequisites.md)
 2. [🛠️ Using ReVanced CLI](1_usage.md)
+3. [🔨 Building ReVanced CLI](2_building.md)

gradle.properties

@@ -1,4 +1,4 @@
 org.gradle.parallel = true
 org.gradle.caching = true
 kotlin.code.style = official
-version = 4.2.0-dev.1
+version = 4.4.0

gradle/libs.versions.toml

@@ -3,8 +3,8 @@ shadow = "8.1.1"
 kotlin-test = "1.9.20"
 kotlinx-coroutines-core = "1.7.3"
 picocli = "4.7.3"
-revanced-patcher = "19.0.0"
-revanced-library = "1.3.0"
+revanced-patcher = "19.1.0"
+revanced-library = "1.4.0"
 
 [libraries]
 kotlin-test = { module = "org.jetbrains.kotlin:kotlin-test", version.ref = "kotlin-test" }

settings.gradle.kts

@@ -2,6 +2,6 @@ rootProject.name = "revanced-cli"
 
 buildCache {
     local {
-        isEnabled = !System.getenv().containsKey("CI")
+        isEnabled = "CI" !in System.getenv()
     }
 }

src/main/kotlin/app/revanced/cli/command/ListCompatibleVersions.kt

@@ -0,0 +1,67 @@
+package app.revanced.cli.command
+
+import app.revanced.library.PackageName
+import app.revanced.library.PatchUtils
+import app.revanced.library.VersionMap
+import app.revanced.patcher.PatchBundleLoader
+import picocli.CommandLine
+import java.io.File
+import java.util.logging.Logger
+
+@CommandLine.Command(
+    name = "list-versions",
+    description = [
+        "List the most common compatible versions of apps that are compatible " +
+            "with the patches in the supplied patch bundles.",
+    ],
+)
+internal class ListCompatibleVersions : Runnable {
+    private val logger = Logger.getLogger(ListCompatibleVersions::class.java.name)
+
+    @CommandLine.Parameters(
+        description = ["Paths to patch bundles."],
+        arity = "1..*",
+    )
+    private lateinit var patchBundles: Array<File>
+
+    @CommandLine.Option(
+        names = ["-f", "--filter-package-names"],
+        description = ["Filter patches by package name."],
+    )
+    private var packageNames: Set<String>? = null
+
+    @CommandLine.Option(
+        names = ["-u", "--count-unused-patches"],
+        description = ["Count patches that are not used by default."],
+        showDefaultValue = CommandLine.Help.Visibility.ALWAYS,
+    )
+    private var countUnusedPatches: Boolean = false
+
+    override fun run() {
+        val patches = PatchBundleLoader.Jar(*patchBundles)
+
+        fun VersionMap.buildVersionsString(): String {
+            if (isEmpty()) return "Any"
+
+            fun buildPatchesCountString(count: Int) = if (count == 1) "1 patch" else "$count patches"
+
+            return entries.joinToString("\n") { (version, count) ->
+                "$version (${buildPatchesCountString(count)})"
+            }
+        }
+
+        fun buildString(entry: Map.Entry<PackageName, VersionMap>) =
+            buildString {
+                val (name, versions) = entry
+                appendLine("Package name: $name")
+                appendLine("Most common compatible versions:")
+                appendLine(versions.buildVersionsString().prependIndent("\t"))
+            }
+
+        PatchUtils.getMostCommonCompatibleVersions(
+            patches,
+            packageNames,
+            countUnusedPatches,
+        ).entries.joinToString("\n", transform = ::buildString).let(logger::info)
+    }
+}

src/main/kotlin/app/revanced/cli/command/MainCommand.kt

@@ -33,9 +33,10 @@ private object CLIVersionProvider : IVersionProvider {
     mixinStandardHelpOptions = true,
     versionProvider = CLIVersionProvider::class,
     subcommands = [
-        ListPatchesCommand::class,
         PatchCommand::class,
         OptionsCommand::class,
+        ListPatchesCommand::class,
+        ListCompatibleVersions::class,
         UtilityCommand::class,
     ],
 )

src/main/kotlin/app/revanced/cli/command/PatchCommand.kt

@@ -325,6 +325,8 @@ internal object PatchCommand : Runnable {
                 alignedFile.renameTo(outputFilePath)
             }
 
+            logger.info("Saved to $outputFilePath")
+
             // endregion
 
             // region Install

src/main/kotlin/app/revanced/cli/command/utility/UtilityCommand.kt

@@ -4,7 +4,7 @@ import picocli.CommandLine
 
 @CommandLine.Command(
     name = "utility",
-    description = ["Commands for utility purposes"],
+    description = ["Commands for utility purposes."],
     subcommands = [InstallCommand::class, UninstallCommand::class],
 )
 internal object UtilityCommand