paris

Define and apply styles to Android views programmatically

APACHE-2.0 License

Stars
1.9K
Committers
18

Bot releases are hidden (Show)

paris - 2.0.2 Latest Release

Published by elihart over 1 year ago

Updates kotlin, ksp, and the xprocessing library.

Notably, the androidx.room:room-compiler-processing library (aka xprocessing) has been updated to 2.6.0-alpha01. This version is incompatible with previous versions due to a breaking API change. All annotation processors using this library must be on the same version. Other annotation processors such as Epoxy and Paris also use xprocessing and if you use them you need to use a version of them that also uses xprocessing 2.6.0-alpha01

paris - 2.0.0

Published by vinaygaba about 3 years ago

Paris now supports Kotlin Symbol Processing for faster builds! https://github.com/google/ksp

Breaking changes needed to support KSP:

  • ParisConfig annotation can no longer be used on package elements, only on class or interfaces
  • R class references used in annotations cannot be star imported
  • Added aggregateStyleablesOnClassPath parameter to @ParisConfig. This must now be set to true to have the module generate a Paris class using only classpath dependencies if there are no Styleables in the module sources.

Note: Due to a bug in KSP (https://github.com/google/ksp/issues/630) it is recommended to disable KSP incremental compilation until the bug is fixed in KSP, otherwise you may encounter spurious build failures.

Additionally, if you are using R2 generation via the butterknife gradle plugin you must configure KSP to be aware of those generated sources.
This can be done either via the experiment KSP setting allowSourcesFromOtherPlugins

// build.gradle.kts
ksp {
    allowSourceFromOtherPlugins=true
}

Or by manually registering R2 sources as an input to KSP

// In a gradle plugin or build.gradle.kts
project.afterEvaluate {
   setUpR2TaskDependency()
}

fun Project.setUpR2TaskDependency() {
    requireAndroidVariants().forEach { variant ->
        val r2Task = runCatching { project.tasks.named("generate${variant.name.capitalize()}R2") }.getOrNull()
        if (r2Task != null) {
            project.tasks.named("ksp${variant.name.capitalize()}Kotlin").dependsOn(r2Task)

            project.extensions.configure(KotlinAndroidProjectExtension::class.java) {
                sourceSets.getByName(variant.name)
                    .kotlin
                    .srcDir("build/generated/source/r2/${variant.name}")
            }
        }
    }
}

/**
 * Return the Android variants for this module, or error if this is not a module with a known Android plugin.
 */
fun Project.requireAndroidVariants(): DomainObjectSet<out BaseVariant> {
    return androidVariants() ?: error("no known android extension found for ${project.name}")
}

/**
 * Return the Android variants for this module, or null if this is not a module with a known Android plugin.
 */
fun Project.androidVariants(): DomainObjectSet<out BaseVariant>? {
    return when (val androidExtension = this.extensions.findByName("android")) {
        is LibraryExtension -> {
            androidExtension.libraryVariants
        }
        is AppExtension -> {
            androidExtension.applicationVariants
        }
        else -> null
    }
}
paris - 1.7.3

Published by elihart over 3 years ago

1.7.3 (April 13, 2021)

  • Fix generated code consistency in module class (#154)
paris - v1.7.2

Published by vinaygaba almost 4 years ago

  • Fixed ArrayOutOfBoundsException on certain devices when ImageView scaleType is set.
paris - 1.7.1

Published by elihart about 4 years ago

  • Change ParisConfig annotation to be applicable to class or interface types. New recommendation is to use it on an interface instead of a package to avoid a bug with spurious incremental annotation failure.

  • Fixed annotation processor bugs with Kotlin 1.4. Project should now be compatible with Kotlin 1.4.x - previous Paris versions would crash at compile time.

paris - 1.6.0

Published by elihart over 4 years ago

Adding support for importantForAccessibility attribute (#138)

paris - 1.5.0

Published by elihart over 4 years ago

Support for incremental annotation processing

paris - v1.4.0

Published by ngsilverman over 4 years ago

  • Added support for namespaced resources.
paris - v1.3.1

Published by ngsilverman almost 5 years ago

  • Fixed precedence of android:textAppearance attribute.
  • Fixed theme attributes not being applied through programmatic styles.
paris - v.1.3.0

Published by ngsilverman over 5 years ago

  • New attribute support:
    • View: android:layout_weight
    • TextView
      • android:line_height
      • android:text_appearance
  • Now using Kotlin nullable types in generated extension functions, rather than @Nullable.
paris - v1.2.1

Published by ngsilverman almost 6 years ago

  • Updated KotlinPoet dependency to 1.0.0.
  • Added @RequiresApi to style builder functions when appropriate.
paris - v1.2.0

Published by ngsilverman almost 6 years ago

  • Set Android version to 28.
  • Migrated to AndroidX.
  • Updated dependencies (ButterKnife, ConstraintLayout, Gradle, Kotlin, Mockito, Testing Compile).
  • Fixed Samsung-specific crash related to android:elevation on Android version 19.
paris - v1.1.0

Published by ngsilverman almost 6 years ago

  • Updated the sample app.
  • Annotations are now included in the "paris" artifact.
  • New attribute support:
    • View
      • android:backgroundTint
      • android:backgroundTintMode
      • android:layout_marginHorizontal
      • android:layout_marginVertical
    • TextView
      • android:drawablePadding
      • android:fontFamily
      • android:inputType
      • android:hint
      • android:maxWidth
      • android:textStyle
  • Added support for null attribute values.
  • Kotlin support:
    • Extensions are now generated for styleable views as an alternative to calling Paris….
    • Added support for @Styleable Kotlin classes.
  • Clarified various error messages.
  • Bugs:
    • Fixed password inputType + singleLine bug.
    • Fixed precedence of margin and padding attribute.
    • Fixed compound drawables not using intrinsic bounds.
paris - v1.0.0

Published by ngsilverman over 6 years ago

  • Apply styles programmatically at any time.
  • Combine multiple styles together.
  • Create styles programmatically (as opposed to using XML).
  • Use annotations to easily support custom attributes.
  • Declare explicitly supported styles for your custom views.
  • And much more...
Package Rankings
Top 9.66% on Repo1.maven.org
Related Projects