docs: add information about downloaders

This is ads fund verification from main branch of revanced manager (flutter) which is diverged from dev branch.

.editorconfig

@@ -1,23 +0,0 @@
-[*.{kt,kts}]
-end_of_line = lf
-ij_kotlin_allow_trailing_comma = false
-ij_kotlin_allow_trailing_comma_on_call_site = false
-ij_kotlin_imports_layout = *
-ij_kotlin_indent_before_arrow_on_new_line = false
-ij_kotlin_line_break_after_multiline_when_entry = true
-ij_kotlin_packages_to_use_import_on_demand = java.util.*,kotlinx.android.synthetic.**
-indent_size = 4
-indent_style = space
-insert_final_newline = true
-ktlint_annotation_handle_annotations_with_parameters_same_as_annotations_without_parameters = [unset]
-ktlint_argument_list_wrapping_ignore_when_parameter_count_greater_or_equal_than = 8
-ktlint_chain_method_rule_force_multiline_when_chain_operator_count_greater_or_equal_than = 4
-ktlint_class_signature_rule_force_multiline_when_parameter_count_greater_or_equal_than = unset
-ktlint_code_style = android_studio
-ktlint_enum_entry_name_casing = upper_or_camel_cases
-ktlint_function_naming_ignore_when_annotated_with = [unset]
-ktlint_function_signature_body_expression_wrapping = default
-ktlint_function_signature_rule_force_multiline_when_parameter_count_greater_or_equal_than = unset
-ktlint_ignore_back_ticked_identifier = false
-ktlint_property_naming_constant_naming = screaming_snake_case
-max_line_length = 100

.github/workflows/build_pull_request.yml

@@ -13,17 +13,10 @@ jobs:
     steps:
       - name: Checkout
         uses: actions/checkout@v4
-        with:
-          fetch-depth: 0
 
       - name: Cache Gradle
         uses: burrunan/gradle-cache-action@v1
 
-      - name: Spotless Check
-        env:
-          GITHUB_TOKEN: ${{ secrets.GITHUB_TOKEN }}
-        run: ./gradlew spotlessCheck --no-daemon
-
       - name: Build
         env:
           GITHUB_TOKEN: ${{ secrets.GITHUB_TOKEN }}

.github/workflows/release.yml

@@ -12,14 +12,13 @@ jobs:
     name: Release
     permissions:
       contents: write
+      packages: write
       id-token: write
       attestations: write
     runs-on: ubuntu-latest
     steps:
       - name: Checkout
         uses: actions/checkout@v4
-        with:
-          fetch-depth: 0
 
       - name: Setup Java
         uses: actions/setup-java@v4
@@ -28,10 +27,11 @@ jobs:
           java-version: '17'
 
       - name: Cache Gradle
-        uses: burrunan/gradle-cache-action@v1
+        uses: burrunan/gradle-cache-action@v3
 
       - name: Build
         env:
+          GITHUB_ACTOR: ${{ github.actor }}
           GITHUB_TOKEN: ${{ secrets.GITHUB_TOKEN }}
         run: ./gradlew assembleRelease
 
@@ -55,18 +55,26 @@ jobs:
         run: |
           echo "${{ secrets.KEYSTORE }}" | base64 --decode > "app/keystore.jks"
 
-      - name: Semantic Release
-        uses: cycjimmy/semantic-release-action@v4
-        id: semantic
+      - name: Release API
+        run: npx multi-semantic-release --tag-format 'api@${version}' --ignore-packages app
         env:
+          GITHUB_ACTOR: ${{ github.actor }}
+          GITHUB_TOKEN: ${{ secrets.GITHUB_TOKEN }}
+
+      - name: Release
+        id: release
+        run: |
+          echo "NEW_TAG=$(npx multi-semantic-release --tag-format 'v${version}' --ignore-packages api | tee | grep 'Created tag ' | sed -E 's/.*Created tag ([^ ]+).*/\1/')" >> $GITHUB_OUTPUT
+        env:
+          GITHUB_ACTOR: ${{ github.actor }}
           GITHUB_TOKEN: ${{ secrets.GITHUB_TOKEN }}
           KEYSTORE_PASSWORD: ${{ secrets.KEYSTORE_PASSWORD }}
           KEYSTORE_ENTRY_ALIAS: ${{ secrets.KEYSTORE_ENTRY_ALIAS }}
           KEYSTORE_ENTRY_PASSWORD: ${{ secrets.KEYSTORE_ENTRY_PASSWORD }}
 
       - name: Attest
-        if: steps.semantic.outputs.new_release_published == 'true'
+        if: steps.release.outputs.NEW_TAG != ''
         uses: actions/attest-build-provenance@v2
         with:
-          subject-name: 'ReVanced Manager ${{ steps.release.outputs.new_release_git_tag }}'
+          subject-name: 'ReVanced Manager ${{ steps.release.outputs.NEW_TAG }}'
           subject-path: app/build/outputs/apk/release/revanced-manager*.apk

adsfund.json

@@ -0,0 +1,8 @@
+{
+  "info": "This is verification file for ads.fund project",
+  "project": {
+    "name": "ReVanced Manager",
+    "walletAddress": "0x7ab4091e00363654bf84B34151225742cd92FCE5",
+    "tokenAddress": "0xadf954bc6f509b3a32fb5e97ed4ba6c000e37155"
+  }
+}

api/.releaserc

@@ -0,0 +1,39 @@
+{
+  "branches": [
+    "main",
+    {
+      "name": "dev",
+      "prerelease": true
+    }
+  ],
+  "plugins": [
+    [
+      "@semantic-release/commit-analyzer",
+      {
+        "releaseRules": [
+          { "type": "build", "scope": "Needs bump", "release": "patch" }
+        ]
+      }
+    ],
+    "@semantic-release/release-notes-generator",
+    "@semantic-release/changelog",
+    "gradle-semantic-release-plugin",
+    [
+      "@semantic-release/git",
+      {
+        "assets": [
+          "CHANGELOG.md",
+          "gradle.properties"
+        ],
+        "message": "chore: Release API v${nextRelease.version} [skip ci]\n\n${nextRelease.notes}"
+      }
+    ],
+    [
+      "@saithodev/semantic-release-backmerge",
+      {
+        "backmergeBranches": [{"from": "main", "to": "dev"}],
+        "clearWorkspace": true
+      }
+    ]
+  ]
+}

api/build.gradle.kts

@@ -1,5 +1,3 @@
-import java.io.IOException
-
 plugins {
     alias(libs.plugins.android.library)
     alias(libs.plugins.kotlin.android)
@@ -19,43 +17,6 @@ dependencies {
     implementation(libs.appcompat)
 }
 
-fun String.runCommand(): String {
-    val process = ProcessBuilder(split("\\s".toRegex()))
-        .redirectErrorStream(true)
-        .directory(rootDir)
-        .start()
-
-    val output = StringBuilder()
-    val reader = process.inputStream.bufferedReader()
-
-    val thread = Thread {
-        reader.forEachLine {
-            output.appendLine(it)
-        }
-    }
-    thread.start()
-
-    if (!process.waitFor(10, TimeUnit.SECONDS)) {
-        process.destroy()
-        throw IOException("Command timed out: $this")
-    }
-
-    thread.join()
-    return output.toString().trim()
-}
-
-val projectPath: String = projectDir.relativeTo(rootDir).path
-val lastTag = "git describe --tags --abbrev=0".runCommand()
-val hasChangesInThisModule = "git diff --name-only $lastTag..HEAD".runCommand().lineSequence().any {
-    it.startsWith(projectPath)
-}
-
-tasks.matching { it.name.startsWith("publish") }.configureEach {
-    onlyIf {
-        hasChangesInThisModule
-    }
-}
-
 android {
     namespace = "app.revanced.manager.plugin.downloader"
     compileSdk = 35
@@ -147,4 +108,4 @@ publishing {
 signing {
     useGpgCmd()
     sign(publishing.publications["Api"])
-}
+}

api/gradlew

@@ -0,0 +1 @@
+../gradlew

api/package.json

@@ -0,0 +1,11 @@
+{
+  "name": "api",
+  "private": false,
+  "devDependencies": {
+    "@anolilab/multi-semantic-release": "^1.1.10",
+    "@saithodev/semantic-release-backmerge": "^4.0.1",
+    "@semantic-release/changelog": "^6.0.3",
+    "@semantic-release/git": "^10.0.1",
+    "gradle-semantic-release-plugin": "^1.10.1"
+  }
+}

app/.releaserc

@@ -8,7 +8,8 @@
   ],
   "plugins": [
     [
-      "@semantic-release/commit-analyzer", {
+      "@semantic-release/commit-analyzer",
+      {
         "releaseRules": [
           { "type": "build", "scope": "Needs bump", "release": "patch" }
         ]
@@ -22,7 +23,7 @@
       {
         "assets": [
           "CHANGELOG.md",
-          "gradle.properties",
+          "gradle.properties"
         ],
         "message": "chore: Release v${nextRelease.version} [skip ci]\n\n${nextRelease.notes}"
       }
@@ -32,17 +33,17 @@
       {
         "assets": [
           {
-            "path": "app/build/outputs/apk/release/revanced-manager*.apk?(.asc)"
-          },
+            "path": "build/outputs/apk/release/revanced-manager*.apk?(.asc)"
+          }
         ],
-        successComment: false
+        "successComment": false
       }
     ],
     [
       "@saithodev/semantic-release-backmerge",
       {
-        backmergeBranches: [{"from": "main", "to": "dev"}],
-        clearWorkspace: true
+        "backmergeBranches": [{"from": "main", "to": "dev"}],
+        "clearWorkspace": true
       }
     ]
   ]

app/build.gradle.kts

@@ -1,3 +1,4 @@
+import io.github.z4kn4fein.semver.toVersion
 import kotlin.random.Random
 
 plugins {
@@ -109,6 +110,16 @@ dependencies {
     implementation(libs.compose.icons.fontawesome)
 }
 
+buildscript {
+    repositories {
+        mavenCentral()
+    }
+    dependencies {
+        // Semantic versioning string parser
+        classpath(libs.semver.parser)
+    }
+}
+
 android {
     namespace = "app.revanced.manager"
     compileSdk = 35
@@ -118,8 +129,15 @@ android {
         applicationId = "app.revanced.manager"
         minSdk = 26
         targetSdk = 35
-        versionCode = 1
-        versionName = "0.0.1"
+
+        val versionStr = if (version == "unspecified") "1.0.0" else version.toString()
+        versionName = versionStr
+        versionCode = with(versionStr.toVersion()) {
+            major * 10_000_000 +
+                    minor * 10_000 +
+                    patch * 100 +
+                    (preRelease?.substringAfterLast('.')?.toInt() ?: 99)
+        }
         vectorDrawables.useSupportLibrary = true
     }
 

app/gradlew

@@ -0,0 +1 @@
+../gradlew

app/package.json

@@ -0,0 +1,11 @@
+{
+  "name": "app",
+  "private": false,
+  "devDependencies": {
+    "@anolilab/multi-semantic-release": "^1.1.10",
+    "@saithodev/semantic-release-backmerge": "^4.0.1",
+    "@semantic-release/changelog": "^6.0.3",
+    "@semantic-release/git": "^10.0.1",
+    "gradle-semantic-release-plugin": "^1.10.1"
+  }
+}

app/proguard-rules.pro

@@ -1,63 +1,14 @@
-# Add project specific ProGuard rules here.
-# You can control the set of applied configuration files using the
-# proguardFiles setting in build.gradle.kts.kts.
-#
-# For more details, see
-#   http://developer.android.com/guide/developing/tools/proguard.html
-
 -dontobfuscate
 
-# Required for serialization to work properly
--if @kotlinx.serialization.Serializable class **
--keepclassmembers class <1> {
-    static <1>$Companion Companion;
-}
--if @kotlinx.serialization.Serializable class ** {
-    static **$* *;
-}
--keepclassmembers class <2>$<3> {
-    kotlinx.serialization.KSerializer serializer(...);
-}
--if @kotlinx.serialization.Serializable class ** {
-    public static ** INSTANCE;
-}
--keepclassmembers class <1> {
-    public static <1> INSTANCE;
-    kotlinx.serialization.KSerializer serializer(...);
-}
+-keep class app.revanced.manager.patcher.runtime.process.* { *; }
+-keep class app.revanced.manager.plugin.** { *; }
+-keep class app.revanced.patcher.** { *; }
+-keep class com.android.tools.smali.** { *; }
+-keep class kotlin.** { *; }
+-keepnames class com.android.apksig.internal.** { *; }
+-keepnames class org.xmlpull.** { *; }
 
-# This required for the process runtime.
--keep class app.revanced.manager.patcher.runtime.process.* {
-  *;
-}
-# Required for the patcher to function correctly
--keep class app.revanced.patcher.** {
-  *;
-}
--keep class brut.** {
-  *;
-}
--keep class org.xmlpull.** {
-  *;
-}
--keep class kotlin.** {
-  *;
-}
--keep class org.jf.** {
-  *;
-}
--keep class com.android.** {
-  *;
-}
--keep class app.revanced.manager.plugin.** {
-  *;
-}
-
--dontwarn com.google.auto.value.**
+-dontwarn com.google.j2objc.annotations.*
 -dontwarn java.awt.**
 -dontwarn javax.**
--dontwarn org.slf4j.**
--dontwarn it.skrape.fetcher.*
--dontwarn com.google.j2objc.annotations.*
-
--keepattributes RuntimeVisibleAnnotations,AnnotationDefault
+-dontwarn org.slf4j.**

app/src/main/java/app/revanced/manager/network/service/HttpService.kt

@@ -8,7 +8,6 @@ import app.revanced.manager.util.tag
 import io.ktor.client.HttpClient
 import io.ktor.client.call.body
 import io.ktor.client.request.HttpRequestBuilder
-import io.ktor.client.request.get
 import io.ktor.client.request.prepareGet
 import io.ktor.client.request.request
 import io.ktor.client.statement.bodyAsText
@@ -92,9 +91,5 @@ class HttpService(
         builder: HttpRequestBuilder.() -> Unit
     ) = saveLocation.outputStream().use { streamTo(it, builder) }
 
-    suspend fun getHtml(builder: HttpRequestBuilder.() -> Unit) = htmlDocument(
-        html = http.get(builder).bodyAsText()
-    )
-
     class HttpException(status: HttpStatusCode) : Exception("Failed to fetch: http status: $status")
 }

build.gradle.kts

@@ -7,12 +7,4 @@ plugins {
     alias(libs.plugins.kotlin.parcelize) apply false
     alias(libs.plugins.about.libraries) apply false
     alias(libs.plugins.compose.compiler) apply false
-    alias(libs.plugins.spotless)
-}
-
-spotless {
-    kotlin {
-        target("app/src/*/java/**/*.kt", "api/src/*/kotlin/**/*.kt")
-        ktlint().setEditorConfigPath("$projectDir/.editorconfig")
-    }
 }

docs/2_3_managing_patches.md

@@ -16,7 +16,7 @@ Learn how to add new, manage existing or remove patches.
 
 ## ⏭️ What's next
 
-The next page will explain how to update ReVanced Manager.
+The next page will explain how to manage downloaders.
 
-Continue: [🔄 Updating ReVanced Manager](2_4_updating.md)
+Continue: [🔄 Updating ReVanced Manager](2_4_managing_downloaders.md)
 

docs/2_4_managing_downloaders.md

@@ -0,0 +1,15 @@
+# 🧩 Managing downloaders
+
+Learn how to manage downloaders.
+Refer to the [template](https://github.com/ReVanced/revanced-manager-downloader-template) if you are developer who wants to create a plugin.
+
+Downloaders are Apk files and are installed, updated and uninstalled just like regular Android apps.
+Downloaders can execute arbitrary code inside ReVanced Manager and must be marked as trusted before use. Manager will show a notification in the dashboard when a new downloader is discovered.
+Trust can also be granted and revoked under `Settings` > `Downloads`.
+
+## ⏭️ What's next
+
+The next page will explain how to update ReVanced Manager.
+
+Continue: [🔄 Updating ReVanced Manager](2_5_updating.md)
+

docs/2_5_updating.md

@@ -15,4 +15,4 @@ and let you when an update is available.
 
 The next page will explain how to configure ReVanced Manager.
 
-Continue: [⚙️ Configuring ReVanced Manager](2_5_settings.md)
+Continue: [⚙️ Configuring ReVanced Manager](2_6_settings.md)

gradle.properties

@@ -1,28 +1,6 @@
-# Project-wide Gradle settings.
-# IDE (e.g. Android Studio) users:
-# Gradle settings configured through the IDE *will override*
-# any settings specified in this file.
-# For more details on how to configure your build environment visit
-# http://www.gradle.org/docs/current/userguide/build_environment.html
-# Specifies the JVM arguments used for the daemon process.
-# The setting is particularly useful for tweaking memory settings.
 org.gradle.jvmargs=-Xmx2048m -Dfile.encoding=UTF-8
-# When configured, Gradle will run in incubating parallel mode.
-# This option should only be used with decoupled projects. More details, visit
-# http://www.gradle.org/docs/current/userguide/multi_project_builds.html#sec:decoupled_projects
-# org.gradle.parallel=true
-# AndroidX package structure to make it clearer which packages are bundled with the
-# Android operating system, and which are packaged with your app's APK
-# https://developer.android.com/topic/libraries/support-library/androidx-rn
 android.useAndroidX=true
-# Kotlin code style for this project: "official" or "obsolete":
 kotlin.code.style=official
-# Enables namespacing of each library's R class so that its R class includes only the
-# resources declared in the library itself and none from the library's dependencies,
-# thereby reducing the size of the R class for that library
 android.nonTransitiveRClass=true
 android.nonFinalResIds=false
-# Task :app:assembleReleaseSignApk fails if this is set to true.
-org.gradle.configuration-cache=false
 org.gradle.caching=true
-version=1.25.0-dev.1

gradle/libs.versions.toml

@@ -36,7 +36,7 @@ compose-icons = "1.2.4"
 kotlin-process = "1.5.1"
 hidden-api-stub = "4.3.3"
 binary-compatibility-validator = "0.17.0"
-spotless-gradle-plugin = "7.0.4"
+semver-parser = "3.0.0"
 
 [libraries]
 # AndroidX Core
@@ -130,6 +130,9 @@ reorderable = { module = "sh.calvin.reorderable:reorderable", version.ref = "reo
 # switch to br.com.devsrsouza.compose.icons after DevSrSouza/compose-icons#30 is merged
 compose-icons-fontawesome = { group = "com.github.BenjaminHalko.compose-icons", name = "font-awesome", version.ref = "compose-icons" }
 
+# Semantic versioning parser
+semver-parser = { module = "io.github.z4kn4fein:semver", version.ref = "semver-parser" }
+
 [plugins]
 android-application = { id = "com.android.application", version.ref = "android-gradle-plugin" }
 android-library = { id = "com.android.library", version.ref = "android-gradle-plugin" }
@@ -140,4 +143,3 @@ compose-compiler = { id = "org.jetbrains.kotlin.plugin.compose", version.ref = "
 devtools = { id = "com.google.devtools.ksp", version.ref = "dev-tools-gradle-plugin" }
 about-libraries = { id = "com.mikepenz.aboutlibraries.plugin", version.ref = "about-libraries-gradle-plugin" }
 binary-compatibility-validator = { id = "org.jetbrains.kotlinx.binary-compatibility-validator", version.ref = "binary-compatibility-validator" }
-spotless = { id = "com.diffplug.spotless", version.ref = "spotless-gradle-plugin" }

package.json

@@ -1,10 +1,11 @@
 {
+  "private": true,
+  "workspaces": [
+    "api",
+    "app"
+  ],
   "devDependencies": {
-    "@anolilab/multi-semantic-release": "^1.1.10",
-    "gradle-semantic-release-plugin": "^1.10.1",
-    "@saithodev/semantic-release-backmerge": "^4.0.1",
-    "@semantic-release/changelog": "^6.0.3",
-    "@semantic-release/exec": "^6.0.3",
-    "@semantic-release/git": "^10.0.1"
+    "@anolilab/multi-semantic-release": "^2.0.3",
+    "semantic-release": "^24.2.7"
   }
 }