Skip to content

Troubleshooting

Gradle cannot resolve ShaderX

Use the published dependency io.github.debanshu777:shaderx:0.1.4. Confirm mavenCentral() is in dependency repositories, not just plugin repositories, and check that Gradle is not offline. For variant-selection errors, compare your JDK and Kotlin targets with the installation requirements. Use Maven Local only when intentionally testing a local build.

Unresolved import or missing effect

The package prefix is com.debanshu.shaderlab.shaderx, even though the Maven group is io.github.debanshu777. Import the shaderEffect extension from .compose and effects from .effect.impl.

AudioVisualizerEffect, texture uniforms, and the other effects added in 0.1.4 require 0.1.4; they are not part of 0.1.3. Custom effects in external modules should implement RuntimeShaderEffect; the abstract base classes require internal handlers.

Unsupported Android SDK or JVM target

ShaderX requires Android API 33+. Set your app's minSdk accordingly and run on a compatible device. Use JDK 21 for Gradle. If the build selects another JDK, check your IDE's Gradle JDK, JAVA_HOME, and gradle/gradle-daemon-jvm.properties.

The contributor checkout also requires the Android compile SDK specified in gradle/libs.versions.toml, even for some desktop tasks, because Android modules are configured in the same build.

No visible effect

  • Confirm the composable draws content and has a nonzero size.
  • Attach an onError callback; inspect shader compilation errors.
  • Confirm the effect's intensity is not zero and the effect itself is not null.
  • For custom source, match uniform names/types and use pixel coordinates.
  • If you supply knownSize, keep it aligned with the actual size in pixels.

Composite effects fail on iOS, desktop, or web

Multi-effect chains are supported only on Android. Skia reports ShaderError.UnsupportedEffect. Use one effect or combine its operations into a single shader. See the platform matrix.

Animation or audio does not update

In 0.1.4, pass a standalone AnimatedShaderEffect directly to shaderEffect. Use animate = true to advance time. Avoid wrapping it in a composite if you expect the modifier to manage its clock.

For audio, supply a live bitmap source using withFftDataSource. Verify microphone permission and that the bitmap contains data with the expected number of bins. Browser microphone capture requires HTTPS or localhost. Pausing time does not pause live uniform refresh in 0.1.4.

If you replace an effect's bitmap instead of using a live source, change frameDataKey with the bitmap. Live images are deliberately excluded from structural equality; the key lets composition deliver the new instance to the existing session. Manually created sessions must be closed when finished and must not be refreshed afterward.

Image export fails on Android

Android's offline export is unsupported because a software bitmap canvas cannot render a hardware RenderNode. In 0.1.4, the processor returns ProcessingError before image decoding or shader creation, including for malformed input bytes. On-screen Compose rendering is a separate path. See image processing for supported uses.

Report a reproducible problem

Include the library version or commit, Kotlin/Compose versions, platform and OS/device, a minimal code sample, and the full error message. Use the bug report form. Remove tokens and personal data before attaching logs or recordings.