fix: Fix for issue 5

Author: vietnguyentuan2019

CHANGELOG.md

@@ -1,5 +1,11 @@
 # Changelog
 
+## [1.2.2] - 2026-04-01
+
+### 🐛 Bug Fixes
+
+- **Android build failure with modern compileSdk** (`example/android/build.gradle.kts`): `irondash_engine_context 0.5.5` was compiled against android-31 but its transitive `androidx.fragment:1.7.1` dependency has `minCompileSdk=34`, causing AGP 8's `checkAarMetadata` to block the build. Added a `subprojects { afterEvaluate { compileSdk = 35 } }` override in the example's root Gradle file. README now documents the same one-line workaround for app-level projects. ([#5](https://github.com/brewkits/hyper_render/issues/5))
+
 ## [1.2.1] - 2026-03-31
 
 ### 🏗️ Maintenance

README.md

@@ -39,7 +39,7 @@
 
 ```yaml
 dependencies:
-  hyper_render: ^1.2.1
+  hyper_render: ^1.2.2
 ```
 
 ```dart
@@ -53,6 +53,21 @@ HyperViewer(
 
 Zero configuration. XSS sanitization is **on by default**.
 
+> **Android note:** `hyper_render` depends on `super_clipboard` which transitively pulls in `irondash_engine_context`. That library was compiled against Android SDK 31, but its `androidx.fragment:1.7.1` dependency requires `compileSdk ≥ 34`. Add this one-time workaround to your `android/build.gradle.kts`:
+>
+> ```kotlin
+> // android/build.gradle.kts  (root — not app/build.gradle.kts)
+> subprojects {
+>     afterEvaluate {
+>         extensions.findByType(com.android.build.gradle.LibraryExtension::class.java)?.apply {
+>             compileSdk = 35
+>         }
+>     }
+> }
+> ```
+>
+> This overrides `compileSdk` for all library sub-projects so AGP's `checkAarMetadata` passes. Tracked in [#5](https://github.com/brewkits/hyper_render/issues/5).
+
 ---
 
 ## 🏗️ Why Switch? The Architecture Argument

example/android/build.gradle.kts

@@ -19,6 +19,19 @@ subprojects {
     project.evaluationDependsOn(":app")
 }
 
+// Workaround: irondash_engine_context 0.5.5 was compiled against android-31 but
+// transitively requires androidx.fragment:1.7.1 which has minCompileSdk=34.
+// AGP 8 checkAarMetadata blocks the build. Override compileSdk for all library
+// subprojects so the check passes.
+// Tracked: https://github.com/brewkits/hyper_render/issues/5
+subprojects {
+    afterEvaluate {
+        extensions.findByType(com.android.build.gradle.LibraryExtension::class.java)?.apply {
+            compileSdk = 35
+        }
+    }
+}
+
 tasks.register<Delete>("clean") {
     delete(rootProject.layout.buildDirectory)
 }

pubspec.yaml

@@ -1,6 +1,6 @@
 name: hyper_render
 description: "Render HTML/Markdown/Delta at 60 FPS. The only Flutter renderer with CSS float layout, crash-free text selection, and CJK Ruby typography. Drop-in flutter_html alternative."
-version: 1.2.1
+version: 1.2.2
 homepage: https://github.com/brewkits/hyper_render
 repository: https://github.com/brewkits/hyper_render
 issue_tracker: https://github.com/brewkits/hyper_render/issues

pubspec_publish_ready.yaml

@@ -1,6 +1,6 @@
 name: hyper_render
 description: "Render HTML/Markdown/Delta at 60 FPS. The only Flutter renderer with CSS float layout, crash-free text selection, and CJK Ruby typography. Drop-in flutter_html alternative."
-version: 1.2.1
+version: 1.2.2
 homepage: https://github.com/brewkits/hyper_render
 repository: https://github.com/brewkits/hyper_render
 issue_tracker: https://github.com/brewkits/hyper_render/issues