e2e: consistent tests across platforms (#690)

## 📜 Description

Made e2e tests better 🙂 

## 💡 Motivation and Context

The main motivation to do that was to have `device.tap()` method - it
would allow us to test switch to emoji keyboard. I added this, but then
realized, that flag `SOFT_CHECK` doesn't satisfy for previous goals, so
I decided to create `devicePreferences` mechanism.

Then I tried to enable `OverKeyboardView` tests and suddenly they
started to work 😲

Last piece was updating `KeyboardToolbar` tests 🙂 

## 📢 Changelog

<!-- High level overview of important changes -->
<!-- For example: fixed status bar manipulation; added new types
declarations; -->
<!-- If your changes don't affect one of platform/language below - then
remove this platform/language -->

### E2E

- enable emoji keyboard tests on iOS;
- enable `OverKeyboardView` tests on iOS;
- update detox to latest version;
- fix `KeyboardToolbar` incompatibility with new Detox version;
- add `getDevicePreference` method;
- generate missing assets;

## 🤔 How Has This Been Tested?

Tested on CI.

## 📝 Checklist

- [x] CI successfully passed
- [x] I added new mocks and corresponding unit-tests if library API was
changed

Author: kirillzyusko

docs/docs/api/over-keyboard-view/index.mdx

@@ -120,7 +120,3 @@ const styles = StyleSheet.create({
   },
 });
 ```
-
-## Limitations
-
-- at the moment it's not possible to write e2e tests using [Detox](https://github.com/wix/Detox) on **iOS** (Android tests are working fine) because clicks are not propagated to the `OverKeyboardView` component (I'm actively working to fix that).

docs/versioned_docs/version-1.14.0/api/over-keyboard-view/index.mdx

@@ -120,7 +120,3 @@ const styles = StyleSheet.create({
   },
 });
 ```
-
-## Limitations
-
-- at the moment it's not possible to write e2e tests using [Detox](https://github.com/wix/Detox) on **iOS** (Android tests are working fine) because clicks are not propagated to the `OverKeyboardView` component (I'm actively working to fix that).

e2e/kit/001-keyboard-animation.e2e.ts

@@ -1,6 +1,5 @@
 import { expectBitmapsToBeEqual } from "./asserts";
 import {
-  Env,
   closeKeyboard,
   switchToEmojiKeyboard,
   waitAndTap,
@@ -22,21 +21,19 @@ describe("Simple keyboard animation", () => {
   });
 
   it("should have expected state when emoji keyboard is opened", async () => {
-    // this is available only on Android 12 right now:
-    // - Android 9 AOSP image can not switch to emoji
-    // - on iOS we are waiting for new API: https://github.com/wix/Detox/issues/4331
-    if (Env.softCheck) {
-      await switchToEmojiKeyboard();
-      await waitForExpect(async () => {
-        await expectBitmapsToBeEqual("KeyboardAnimationEmojiKeyboard");
-      });
-    }
+    await switchToEmojiKeyboard();
+    await waitForExpect(async () => {
+      await expectBitmapsToBeEqual("KeyboardAnimationEmojiKeyboard");
+    });
   });
 
   it("should have expected state when keyboard is closed", async () => {
+    // only on iOS 15 we get busy loop...
+    await device.disableSynchronization();
     await closeKeyboard("keyboard_animation_text_input");
     await waitForExpect(async () => {
       await expectBitmapsToBeEqual("KeyboardAnimationKeyboardIsHidden");
     });
+    await device.enableSynchronization();
   });
 });

e2e/kit/005-keyboard-toolbar.e2e.ts

@@ -7,6 +7,7 @@ import {
 import {
   doActionNTimes,
   scrollDownUntilElementIsVisible,
+  tap,
   waitAndTap,
   waitForElementById,
   waitForExpect,
@@ -28,14 +29,14 @@ describe("`KeyboardToolbar` specification", () => {
   });
 
   it("should show bottom sheet when `AutoFill Contacts` is pressed", async () => {
-    await waitAndTap("autofill_contacts");
+    await tap("autofill_contacts");
     await waitForElementById("autofill_contacts_close");
   });
 
   it("should set focus back when modal closed", async () => {
     await waitAndTap("autofill_contacts_close");
     await expect(element(by.id("TextInput#1"))).toBeFocused();
-    await waitAndTap("autofill_contacts");
+    await tap("autofill_contacts");
   });
 
   it("should do correct actions when contact gets selected", async () => {
@@ -56,22 +57,22 @@ describe("`KeyboardToolbar` specification", () => {
   });
 
   it("should skip a disabled fields", async () => {
-    await waitAndTap("keyboard.toolbar.next");
+    await tap("keyboard.toolbar.next");
     await expect(element(by.id("TextInput#5"))).toBeFocused();
   });
 
   it("should handle multiple clicks in row", async () => {
-    await doActionNTimes(() => waitAndTap("keyboard.toolbar.next"), 3);
+    await doActionNTimes(() => tap("keyboard.toolbar.next"), 3);
     await expect(element(by.id("TextInput#8"))).toBeFocused();
   });
 
   it("should handle `previous` clicks correctly", async () => {
-    await waitAndTap("keyboard.toolbar.previous");
+    await tap("keyboard.toolbar.previous");
     await expect(element(by.id("TextInput#7"))).toBeFocused();
   });
 
   it("should have expected UI state when end of form reached", async () => {
-    await doActionNTimes(() => waitAndTap("keyboard.toolbar.next"), 6);
+    await doActionNTimes(() => tap("keyboard.toolbar.next"), 6);
     await expect(element(by.id("TextInput#13"))).toBeFocused();
     await expectElementBitmapsToBeEqual(
       "keyboard.toolbar",
@@ -80,7 +81,7 @@ describe("`KeyboardToolbar` specification", () => {
   });
 
   it("should enable next button when go to previous field from the last one", async () => {
-    await waitAndTap("keyboard.toolbar.previous");
+    await tap("keyboard.toolbar.previous");
     await expect(element(by.id("TextInput#12"))).toBeFocused();
     await expectElementBitmapsToBeEqual(
       "keyboard.toolbar",
@@ -89,7 +90,7 @@ describe("`KeyboardToolbar` specification", () => {
   });
 
   it("should close keyboard when press `Done`", async () => {
-    await waitAndTap("keyboard.toolbar.done");
+    await tap("keyboard.toolbar.done");
     await waitForExpect(async () => {
       await expectBitmapsToBeEqual("ToolbarKeyboardClosed");
     });

e2e/kit/009-native-stack.e2e.ts

@@ -1,6 +1,5 @@
 import { expectBitmapsToBeEqual } from "./asserts";
 import {
-  Env,
   closeKeyboard,
   scrollDownUntilElementIsVisible,
   switchToEmojiKeyboard,
@@ -24,21 +23,19 @@ describe("Native stack", () => {
   });
 
   it("should have expected state when emoji keyboard is opened", async () => {
-    // this is available only on Android 12 right now:
-    // - Android 9 AOSP image can not switch to emoji
-    // - on iOS we are waiting for new API: https://github.com/wix/Detox/issues/4331
-    if (Env.softCheck) {
-      await switchToEmojiKeyboard();
-      await waitForExpect(async () => {
-        await expectBitmapsToBeEqual("NativeStackEmojiKeyboard");
-      });
-    }
+    await switchToEmojiKeyboard();
+    await waitForExpect(async () => {
+      await expectBitmapsToBeEqual("NativeStackEmojiKeyboard");
+    });
   });
 
   it("should have expected state when keyboard is closed", async () => {
+    // only on iOS 15 we get busy loop...
+    await device.disableSynchronization();
     await closeKeyboard("keyboard_animation_text_input");
     await waitForExpect(async () => {
       await expectBitmapsToBeEqual("NativeStackKeyboardIsHidden");
     });
+    await device.enableSynchronization();
   });
 });

e2e/kit/011-over-keyboard-view.e2e.ts

@@ -6,9 +6,7 @@ import {
   waitForExpect,
 } from "./helpers";
 
-const test = device.getPlatform() === "ios" ? describe.skip : describe;
-
-test("`OverKeyboardView` specification", () => {
+describe("`OverKeyboardView` specification", () => {
   it("should navigate to `OverKeyboardView` screen", async () => {
     await scrollDownUntilElementIsVisible(
       "main_scroll_view",
@@ -20,7 +18,8 @@ test("`OverKeyboardView` specification", () => {
   it("should have expected state when view is not visible", async () => {
     await waitForElementById("over_keyboard_view.input");
     await waitForExpect(async () => {
-      await expectBitmapsToBeEqual("OverKeyboardViewNotShown");
+      // iOS home indicator may have different color
+      await expectBitmapsToBeEqual("OverKeyboardViewNotShown", 0.28);
     });
   });
 

e2e/kit/asserts/index.ts

@@ -6,9 +6,8 @@ import pixelmatch from "pixelmatch";
 import { PNG } from "pngjs";
 
 import { delay } from "../helpers";
+import parseDeviceName from "../utils/parseDeviceName";
 
-const parseDeviceName = (name: string) =>
-  name.split("(").pop()?.replace(")", "");
 const getDirFromFilePath = (path: string) =>
   path.substring(0, path.lastIndexOf("/"));