Merge pull request #277 from takahirom/takahirom/add-faq-about-graphi…

…cs-problems/2024-03-16 Add "The images taken from Roborazzi seem broken" FAQ
takahirom · Mar 16, 2024 · ffbb2e1 · ffbb2e1
2 parents 44498e3 + 28daa53
commit ffbb2e1
Show file tree

Hide file tree

Showing 2 changed files with 19 additions and 1 deletion.
diff --git a/README.md b/README.md
@@ -1192,6 +1192,15 @@ roborazzi {
     outputDir = "src/your/screenshot/folder"
 }
 ```
+
+### Q: The images taken from Roborazzi seem broken
+
+**A:** First, please check if you are using the correct version of the Android SDK. Consider using API level 28 or higher because it seems that Robolectric Native Graphics doesn't work property on older SDK versions.
+
+You can specify the SDK version like `@Config(sdk = [33])` or by using `robolectric.properties` with `sdk=33`.  
+[https://robolectric.org/configuring/](https://robolectric.org/configuring/)  
+
+If your images are mostly fine but there are some drawing issues like shadows or shape graphics, you can try using Robolectric's Hardware Rendering mode. Please refer to [this issue](https://github.com/takahirom/roborazzi/issues/255#issuecomment-1972838571).
 </div>
 
 ### LICENSE

diff --git a/docs/topics/faq.md b/docs/topics/faq.md
@@ -93,4 +93,13 @@ out [the issue](https://github.com/takahirom/roborazzi/issues/193#issuecomment-1
 roborazzi {
     outputDir = "src/your/screenshot/folder"
 }
-```
+```
+
+### Q: The images taken from Roborazzi seem broken
+
+**A:** First, please check if you are using the correct version of the Android SDK. Consider using API level 28 or higher because it seems that Robolectric Native Graphics doesn't work property on older SDK versions.
+
+You can specify the SDK version like `@Config(sdk = [33])` or by using `robolectric.properties` with `sdk=33`.  
+[https://robolectric.org/configuring/](https://robolectric.org/configuring/)  
+
+If your images are mostly fine but there are some drawing issues like shadows or shape graphics, you can try using Robolectric's Hardware Rendering mode. Please refer to [this issue](https://github.com/takahirom/roborazzi/issues/255#issuecomment-1972838571).