القائمة
Frequently asked questions about Haze. Use when asked about Haze vs Modifier.blur, cross-platform blur consistency, or which Android versions Haze supports.
التثبيت باستخدام Codex أو Claude انسخ هذا Prompt والصقه في Codex أو Claude أو مساعد آخر ليراجع صفحة Skill ويثبّتها لك.
استنادا إلى تصنيف SOC المهني
Android 架构、依赖注入、数据层、测试规范官方参考。涵盖 UDF/MVI 模式、Hilt/Dagger、Room、Paging、 DataStore、WorkManager、ViewModel、测试策略等。安卓开发第一要义：参考官方文档和案例！ Triggers: "Android 架构", "MVVM", "MVI", "UDF", "Hilt", "Dagger", "Room", "Paging", "ViewModel", "WorkManager", "DataStore", "测试", "架构设计", "DI", "依赖注入"
Jetpack Compose 官方示例与最佳实践参考。涵盖 Compose UI 实现、动画、手势、导航、Material3 主题、 性能优化、测试等所有方面。安卓开发第一要义：参考官方文档和案例！ Triggers: "Compose 怎么写", "Compose 动画", "Compose 导航", "Compose 性能", "Compose 主题", "Jetpack Compose sample", "Material3 Compose", "Compose testing", "Compose best practice"
Android 官方示例代码库完整索引。涵盖架构、Compose UI、性能、测试、存储、网络、相机、媒体、安全等所有领域。 安卓开发第一要义：参考官方文档和案例！遇到任何 Android 开发问题，首先查阅官方示例而非第三方博客。 Triggers: "Android 官方示例", "参考官方代码", "Android sample", "官方架构", "Jetpack sample", "Compose 示例", "Room 示例", "Navigation 示例", "如何实现 XX 功能", "最佳实践"
Expert guidance on Haze blur effect configuration, styling, materials, progressive blur, masking, and input scale. Use when configuring blur radius, tint/color effects, noise, HazeMaterials/CupertinoMaterials/FluentMaterials, gradient blurs, or blur masking.
Expert guidance on building custom VisualEffect implementations for Haze. Use when creating custom shader effects, non-blur visual effects, or extending Haze with new effect types.
Guide for migrating from Haze v1.x to v2.0. Use when upgrading Haze dependencies, fixing compilation errors after a version bump, or converting v1 API calls to v2 syntax.
| name | haze-faq |
| description | Frequently asked questions about Haze. Use when asked about Haze vs Modifier.blur, cross-platform blur consistency, or which Android versions Haze supports. |
Modifier.blur and Haze provide different things:
Haze can also do foreground blurring (omit state from hazeEffect), but background blurring is its primary strength. Haze additionally provides: tint overlays, noise texture, progressive gradients, masking, pre-built materials (Material/Cupertino/Fluent), and multi-platform support.
Use Haze when you need content-behind-blur (app bars, dialogs, cards). Use Modifier.blur for simple content-only blurring.
Yes. The majority of the implementation is shared across all platforms.
The only differences are in platform-specific blur backends:
| Platform | Blur Backend |
|---|---|
| Android 13+ | RenderEffect.createBlurEffect() |
| Android 12 | RenderNode + shader |
| Android 11- | RenderScript |
| Desktop / iOS | Skia shaders |
| Web / Wasm | Canvas filters / custom shaders |
All platforms implement blur in very similar ways — only the platform classes differ.
Haze works on Android API 11+. The experience varies by API level:
| API Level | Blur | Quality | Default |
|---|---|---|---|
| 33+ (Android 13+) | ✅ | Optimal | Enabled |
| 31-32 (Android 12) | ✅ | Good | Enabled |
| ≤30 (Android 11-) | ⚠️ | Laggy (RenderScript) | Disabled (scrim fallback) |
blurEffect { blurEnabled = true }. Expect frame-behind updates.Yes. Haze supports all Compose Multiplatform targets:
| Platform | Supported |
|---|---|
| Android | ✅ |
| Desktop (JVM) | ✅ |
| iOS | ✅ |
| Wasm | ✅ |
| JS/Canvas | ✅ |
Desktop, iOS, and Web all use Skia/Skiko-backed implementations (optimal environment).
Haze is built, tested, and released against the latest stable Compose Multiplatform. Pre-release CMP versions are occasionally verified but not guaranteed. Test thoroughly if using pre-release CMP.
The RenderScript path (API ≤30, Android 11-) does not render blur on the emulator. It works on physical devices only. RenderEffect-based paths (API 31+) work on emulator images that support GPU acceleration.