Skip to content

Troubleshooting

Common issues and solutions when installing Vetra UI.

Compose Version Conflicts

If you encounter version conflicts with Compose, ensure all your Compose dependencies use compatible versions:

[versions]
compose = "1.9.2"
vetraui = "1.0.0-alpha02"

Make sure all Compose dependencies reference the same version:

[versions]
compose = "1.9.2"

[libraries]
compose-ui = { module = "org.jetbrains.compose.ui:ui", version.ref = "compose" }
compose-foundation = { module = "org.jetbrains.compose.foundation:foundation", version.ref = "compose" }
compose-material3 = { module = "org.jetbrains.compose.material3:material3", version.ref = "compose" }

Symbol Resolution Issues

If your IDE can't resolve Vetra UI imports:

  1. Sync Gradle Project
  2. Click "Sync Now" in Android Studio

  3. Or run: ./gradlew build --refresh-dependencies

  4. Invalidate Caches

  5. File → Invalidate Caches...

  6. Select "Invalidate and Restart"

  7. Check Import Path

  8. Ensure you're using: com.flyfishxu.vetraui.core.*

  9. Or specific imports: com.flyfishxu.vetraui.core.VetraButton

  10. Rebuild Project

  11. Build → Rebuild Project

Platform-Specific Issues

iOS

Issue: Build fails on iOS

Solutions: - Make sure you've run pod install in the iosApp directory - Check that iOS deployment target is set to 14.0 or higher - Clean build folder: ./gradlew clean

Desktop

Issue: Desktop app won't run

Solutions: - Ensure you have the correct JVM target (11 or higher recommended) - Check that Java toolchain is configured correctly - Try running: ./gradlew :composeApp:run

Web

Issue: Web build fails or doesn't load

Solutions: - Clear your browser cache - Rebuild the project: ./gradlew clean build - Check browser console for errors - Ensure you're using a modern browser

Build Errors

Gradle Sync Fails

  1. Check your gradle.properties for any conflicting settings
  2. Update Gradle wrapper: ./gradlew wrapper --gradle-version=8.5
  3. Check Kotlin version compatibility

Compilation Errors

  1. Ensure Kotlin version is 2.0.0 or higher
  2. Check Compose Multiplatform version compatibility
  3. Clean and rebuild: ./gradlew clean build

Still Having Issues?

Next Steps

Once resolved: - Verify Installation - Quick Start