README.md

ResourcesPlaceholders

Gradle plugin which adds support for ${placeholder} manifestPlaceholders in Android resource files.

This fork of ResourcePlaceholdersPlugin has been updated to work with newer Gradle versions.

Version 0.11.2 of this fork is known to work with Gradle 8.3.0.

Installation

Add the following to your build.gradle:

Build script snippet for plugins DSL:

plugins {
  id("pt.jcosta.resourceplaceholders") version "X.X.X"
}

Build script snippet for use where dynamic configuration is required:

buildscript {
    repositories {
        // ...
        maven {
          url "https://plugins.gradle.org/m2/"
        }
    }
    dependencies {
        classpath("pt.jcosta.resourceplaceholders:resource-placeholders:X.X.X")
    }
}

apply plugin: 'com.android.application'
apply plugin: "de.timfreiheit.resourceplaceholders"

Usage

A common use case is using the ${applicationId} when defining App Shortcuts. The android:targetPackage must be set statically and can not easily be used with different build variants or types.
Using placeholders the shortcuts.xml file could look something like:

<shortcuts xmlns:android="http://schemas.android.com/apk/res/android">
    <shortcut ...>
        <intent
            android:action="android.intent.action.VIEW"
            android:targetClass="com.test.MainActivity"
            android:targetPackage="${applicationId}"/>
    </shortcut>
</shortcuts>

Register the file in your apps build.gradle to the plugin:

resourcePlaceholders {
    files = ['xml/shortcuts.xml']
}

Every file in which the placeholders should be supported must be listed. This improves incremental builds and avoid unnecessary work.