菜单
Run Wix Engine (mobile-apps-engine) iOS E2E tests locally to validate RNN changes. Use when you need to test RNN fixes against the Engine's Detox test suite.
默认使用会先检查来源的 Prompt；你也可以切换为直接命令，或下载本地副本。
决定是否安装前，请先阅读 SKILL.md，以及 SkillsMP 当前展示的配套文件。
基于 SOC 职业分类
用 Codex 或 Claude 帮你安装 复制这段 Prompt，粘贴到 Codex、Claude 或其他助手里，让它检查 Skill 页面并帮你完成安装。
直接命令不会经过审查 Prompt；运行前请先检查来源。
npx skills add https://github.com/wix/react-native-navigation --skill engine-e2e命令会保持在同一行。复制前请横向滚动并检查完整内容。
想先保存到本地？可下载 SkillsMP 当前能够提供的文件。
正在显示 SKILL.md
Navigate and work with the react-native-navigation (RNN) codebase. Use when fixing bugs, adding features, tracing command flows, understanding options resolution, or working across JS/iOS/Android layers in this repo.
Reference for iOS 26 navigation bar, tab bar, toolbar, and Liquid Glass building blocks (UITab, scroll-edge effects, search placement, shared-background platter, UIButton glass configurations, UIGlassEffect / UIGlassContainerEffect, UINavigationItem.style navigator/browser/editor, UICornerConfiguration / concentric corners, UISheetPresentationController, SF Symbols 7) plus the internal view hierarchy of UIBarButtonItem and UIToolbar, and how react-native-navigation maps to all of it. Use when adding or fixing iOS 26 behavior in RNN's top bar, bottom tabs, bar buttons, toolbar, modals, or any glass-styled custom chrome; when investigating iOS 26-only regressions; or when deciding how to expose a new iOS 26 capability through RNN options.
Navigate and work with the react-native-navigation (RNN) codebase. Use when fixing bugs, adding features, tracing command flows, understanding options resolution, or working across JS/iOS/Android layers in this repo.
| name | engine-e2e |
| description | Run Wix Engine (mobile-apps-engine) iOS E2E tests locally to validate RNN changes. Use when you need to test RNN fixes against the Engine's Detox test suite. |
The Engine app (@wix/wix-one-app-engine) in ~/Documents/mobile-apps-engine consumes RNN
from node_modules/react-native-navigation. To test RNN changes against the Engine's E2E
suite, you patch the Engine's copy of RNN, rebuild the native binary, and run the tests.
nvm use default)CI env var must be unset (not 0, fully unset) to avoid CI-specific codepaths.
Use env -u CI before every command.~/Documents/mobile-apps-engine with yarn install already done.Apply your RNN source changes to the corresponding files under:
~/Documents/mobile-apps-engine/node_modules/react-native-navigation/ios/
The directory structure mirrors the RNN repo's ios/ folder exactly.
cd ~/Documents/mobile-apps-engine
unset PREFIX && . ~/.nvm/nvm.sh > /dev/null && nvm use default > /dev/null
env -u CI yarn workspace @wix/mobile-apps-engine-native-builds build-local-ios
This runs xcodebuild with -quiet flag — expect no output until it finishes.
Takes ~10-15 minutes on M-series Macs.
The build output (.app bundle) lands in:
packages/native/mobile-apps-engine-native-builds/dist/binaries.json
SecKeychainUnlock): The CI env var is set. Use env -u CI.These are needed once per checkout. Skip if already built.
env -u CI yarn workspace @wix/mobile-apps-engine-extra-bundle local:build
env -u CI yarn workspace @wix/mobile-apps-dependencies local:build
cd ~/Documents/mobile-apps-engine
unset PREFIX && . ~/.nvm/nvm.sh > /dev/null && nvm use default > /dev/null
env -u CI yarn workspace @wix/wix-one-app-engine test:e2e:ios -w d <suite_files...>
The -w d flag selects the Detox worker count.
| Suite file | What it tests |
|---|---|
e2e/suites/ExternalLinks.test.js | Deep link navigation, back button |
e2e/suites/ExternalLinksModes.test.js | Deep link modes (pop to root, tab switch) |
e2e/suites/ExternalLinksPushNotifications.test.js | Push notification deep links |
e2e/suites/ExtenalLinksWithSiteSelect.test.js | Deep links with site selection |
e2e/suites/EngineUIComponents.test.js | Error screen, UI components |
e2e/suites/LaunchArgs.test.js | Launch arguments |
e2e/suites/LazyModules.test.js | Lazy-loaded modules |
env -u CI yarn workspace @wix/wix-one-app-engine test:e2e:ios -w d \
e2e/suites/ExternalLinks.test.js \
e2e/suites/ExternalLinksModes.test.js \
e2e/suites/ExternalLinksPushNotifications.test.js
Error: No dist version found: The native build hasn't run or failed.
Run step 2 again.Cannot find module .../mobile-apps-engine-extra-bundle/index.js:
Run step 3 (local:build for extra-bundle).ENOENT .../metadata.json: Run step 3 (local:build for mobile-apps-dependencies).Unable to resolve module @rozenite/...: The Rozenite plugin import is broken.
Patch packages/wix-one-app-engine/src/rozenitePlugin/helper/rozenite-network-inspector.ts
to make the import optional with a no-op fallback.navigateBack(): The navigateBack() helper taps
element(by.id('pop')) on iOS. This relies on RNN's setBackButtonTestID working
correctly. If the back button's view hierarchy changed (e.g., iOS 26 Liquid Glass),
the testID isn't applied and the element can't be found.| File | Purpose |
|---|---|
packages/wix-one-app-engine/e2e/helpers/utils.js | Test helpers including navigateBack() |
packages/wix-one-app-engine/demo-modules/deep-links/module.js | Deep link route definitions |
packages/wix-one-app-engine/demo-modules/deep-links/Screens.js | Deep link screen components |
packages/wix-one-app-engine/internalScripts/test-e2e.js | E2E test runner script |
packages/native/mobile-apps-engine-native-builds/local_build_scripts/build_ios.js | Local iOS build script |