mirror of
https://github.com/bitwarden/android.git
synced 2026-05-03 21:58:40 -05:00
56 lines
1.7 KiB
Markdown
56 lines
1.7 KiB
Markdown
# Troubleshooting
|
|
|
|
## Common Issues
|
|
|
|
### Build fails with SDK dependency error
|
|
|
|
**Problem**: Cannot resolve Bitwarden SDK from GitHub Packages
|
|
|
|
**Solution**:
|
|
1. Ensure `GITHUB_TOKEN` is set in `user.properties` or environment
|
|
2. Verify token has `read:packages` scope
|
|
3. Check network connectivity to `maven.pkg.github.com`
|
|
|
|
### Tests fail with dispatcher issues
|
|
|
|
**Problem**: Tests hang or fail with "Module with Main dispatcher had failed to initialize"
|
|
|
|
**Solution**:
|
|
1. Extend `BaseViewModelTest` for ViewModel tests
|
|
2. Use `@RegisterExtension val mainDispatcherExtension = MainDispatcherExtension()`
|
|
3. Ensure `runTest { }` wraps test body
|
|
|
|
### Compose preview not rendering
|
|
|
|
**Problem**: @Preview functions show "Rendering problem"
|
|
|
|
**Solution**:
|
|
1. Check for missing theme wrapper: `BitwardenTheme { YourComposable() }`
|
|
2. Verify no ViewModel dependency in preview (use state-based preview)
|
|
3. Clean and rebuild project
|
|
|
|
### ProGuard/R8 stripping required classes
|
|
|
|
**Problem**: Release build crashes with missing class errors
|
|
|
|
**Solution**:
|
|
1. Add keep rules to `proguard-rules.pro`
|
|
2. Check `consumer-rules.pro` in library modules
|
|
3. Verify kotlinx.serialization rules are present
|
|
|
|
### App module test flavor errors
|
|
|
|
**Problem**: `./gradlew app:testDebugUnitTest` fails or runs no tests
|
|
|
|
**Solution**: The app module uses build flavors. Use `testStandardDebugUnitTest`:
|
|
```bash
|
|
./gradlew app:testStandardDebugUnitTest
|
|
```
|
|
|
|
## Debug Tips
|
|
|
|
- **Timber Logging**: Enabled in debug builds, check Logcat with tag filter
|
|
- **Debug Menu**: Available in debug builds via Settings > About > Debug Menu
|
|
- **Network Inspector**: Use Android Studio Network Profiler or Charles Proxy
|
|
- **SDK Debugging**: Check `BaseSdkSource` for wrapped exceptions
|