Menu
Minimum SDK/OS version requirements for all OneKey platforms (iOS, Android, Chrome, Electron).
Installer avec Codex ou Claude Copiez ce prompt, collez-le dans Codex, Claude ou un autre assistant, puis laissez-le vérifier la page du skill et l'installer pour vous.
Basé sur la classification professionnelle SOC
| name | 1k-platform-requirements |
| description | Minimum SDK/OS version requirements for all OneKey platforms (iOS, Android, Chrome, Electron). |
| allowed-tools | Read, Grep, Glob, Bash |
When user asks if their device can run app-monorepo, run the environment check to verify all required tools are installed with correct versions.
Important: Xcode, CocoaPods, and Ruby are macOS only tools required for iOS development. On non-macOS systems, skip these checks.
First, detect the operating system:
uname -s
Darwin → macOS, check ALL tools including Xcode/CocoaPodsLinux or other → Skip Xcode/CocoaPods/Ruby checks| Tool | Required Version | How to Check | Platform |
|---|---|---|---|
| Node.js | >=22 | node -v | All |
| Yarn | 4.12.0 | yarn -v | All |
| Java/JDK | 17+ | java -version | All |
| Gradle | 8.13 | ./gradlew --version | All |
| Go | 1.24.0 | go version | All |
| Ruby | 2.7+ (recommended 3.x) | ruby -v | macOS only |
| CocoaPods | 1.16.2 | pod --version | macOS only |
| Xcode | 26.2 | xcodebuild -version | macOS only |
| Android Studio | Ladybug (2024.2.1)+ | Android Studio > About | All |
| Platform | Minimum Version | Notes |
|---|---|---|
| Android | API 24 (Android 7.0 Nougat) | Set by Expo SDK |
| iOS | 15.5 | Deployment target |
| Chrome Extension | Chrome 111+ | Required for MAIN world injection |
| Firefox Extension | Latest stable | Follows Chrome manifest v2 |
| Desktop (Electron) | Electron 39.x | See OS requirements below |
| macOS | 10.15+ (Catalina) | Electron 39 requirement |
| Windows | Windows 10+ | Electron 39 requirement |
| Linux | Ubuntu 20.04+ | Electron 39 requirement |
Location: Set by Expo, referenced in apps/mobile/android/app/build.gradle:142
How to check current value:
cd apps/mobile/android && ./gradlew -q properties 2>&1 | grep -i "minSdk"
Configuration chain:
apps/mobile/android/app/build.gradle references rootProject.ext.minSdkVersionexpo-modules-autolinking in ExpoRootProjectPlugin.ktLocation: apps/mobile/ios/Podfile:18
How to check:
grep "platform :ios" apps/mobile/ios/Podfile
Configuration:
platform :ios, podfile_properties['ios.deploymentTarget'] || '15.5'
Can also verify in Xcode project:
grep "IPHONEOS_DEPLOYMENT_TARGET" apps/mobile/ios/OneKeyWallet.xcodeproj/project.pbxproj | head -5
Location: apps/ext/src/manifest/chrome_v3.js:9
How to check:
grep "minimum_chrome_version" apps/ext/src/manifest/chrome_v3.js
Note: Version 111+ is required for MAIN world content script injection (manifest v3 feature).
Location: apps/ext/src/manifest/firefox.js
Firefox manifest extends Chrome manifest but may have different requirements. Currently follows Chrome manifest v2 patterns.
Location: apps/desktop/package.json
How to check:
grep '"electron":' apps/desktop/package.json
Current version: Electron 39.5.1
Electron 39 OS Requirements:
Reference: Check Electron releases for OS compatibility at https://releases.electronjs.org/
Run this to see all Android SDK versions at once:
cd apps/mobile/android && ./gradlew -q --no-configuration-cache properties 2>&1 | grep -E "(minSdk|compileSdk|targetSdk|buildTools|ndk|kotlin):"
Expected output format:
- buildTools: 36.0.0
- minSdk: 24
- compileSdk: 36
- targetSdk: 36
- ndk: 27.1.12297006
- kotlin: 2.1.20
When updating minimum versions:
Required: >=22
Location: package.json:10-12
How to check configuration:
grep -A2 '"engines"' package.json
Configuration:
"engines": {
"node": ">=22"
}
Required: 4.12.0 (Yarn Berry / Yarn 4)
Location: package.json:3
How to check configuration:
grep '"packageManager"' package.json
Configuration:
"packageManager": "yarn@4.12.0"
Required: JDK 17+
Why: Gradle 8.13 requires Java 17+. The project uses jvmTarget = "17" for Kotlin compilation.
Location: apps/mobile/android/build.gradle:101
How to check configuration:
grep "jvmTarget" apps/mobile/android/build.gradle
Required: 8.13
Location: apps/mobile/android/gradle/wrapper/gradle-wrapper.properties:3
How to check configuration:
grep "distributionUrl" apps/mobile/android/gradle/wrapper/gradle-wrapper.properties
Configuration:
distributionUrl=https\://services.gradle.org/distributions/gradle-8.13-bin.zip
Required: 2.7+ (recommended 3.x for Apple Silicon)
Platform: macOS only - required for iOS development
Why: Required for CocoaPods and iOS build tooling.
How to check:
ruby -v
Note: On macOS, system Ruby may be outdated. Use rbenv or rvm to manage Ruby versions.
Required: 1.16.2
Platform: macOS only - required for iOS development
Location: apps/mobile/ios/Podfile.lock (last line)
How to check configuration:
tail -1 apps/mobile/ios/Podfile.lock
How to install:
gem install cocoapods -v 1.16.2
Required: 1.24.0
Why: Required for compiling gopenpgp cryptographic library on iOS.
Location: apps/mobile/ios/Podfile:33
How to check configuration:
grep "go_version = " apps/mobile/ios/Podfile
Required: 26.2
Platform: macOS only - required for iOS development
Why: Required for building iOS app with latest SDK features and deployment target.
How to check:
xcodebuild -version
Note: Xcode version determines available iOS SDKs and simulator versions.
Required: Ladybug (2024.2.1) or later
Why: compileSdk 36 requires Android Studio with SDK 36 support.
How to check: Android Studio > About Android Studio
Required components:
echo "=== Development Environment Check (macOS) ===" && \
echo "OS: $(uname -s) $(uname -r)" && \
echo "Node.js: $(node -v 2>/dev/null || echo 'NOT INSTALLED')" && \
echo "Yarn: $(yarn -v 2>/dev/null || echo 'NOT INSTALLED')" && \
echo "Java: $(java -version 2>&1 | head -1 || echo 'NOT INSTALLED')" && \
echo "Go: $(go version 2>/dev/null || echo 'NOT INSTALLED')" && \
echo "Ruby: $(ruby -v 2>/dev/null || echo 'NOT INSTALLED')" && \
echo "CocoaPods: $(pod --version 2>/dev/null || echo 'NOT INSTALLED')" && \
echo "Xcode: $(xcodebuild -version 2>/dev/null | head -1 || echo 'NOT INSTALLED')" && \
echo "Gradle (configured): $(grep 'distributionUrl' apps/mobile/android/gradle/wrapper/gradle-wrapper.properties 2>/dev/null | sed 's/.*gradle-\(.*\)-bin.zip/\1/' || echo 'N/A')"
echo "=== Development Environment Check (Non-macOS) ===" && \
echo "OS: $(uname -s) $(uname -r)" && \
echo "Node.js: $(node -v 2>/dev/null || echo 'NOT INSTALLED')" && \
echo "Yarn: $(yarn -v 2>/dev/null || echo 'NOT INSTALLED')" && \
echo "Java: $(java -version 2>&1 | head -1 || echo 'NOT INSTALLED')" && \
echo "Go: $(go version 2>/dev/null || echo 'NOT INSTALLED')" && \
echo "Gradle (configured): $(grep 'distributionUrl' apps/mobile/android/gradle/wrapper/gradle-wrapper.properties 2>/dev/null | sed 's/.*gradle-\(.*\)-bin.zip/\1/' || echo 'N/A')" && \
echo "" && \
echo "Note: Xcode, CocoaPods, Ruby are macOS-only (required for iOS development)"
if [ "$(uname -s)" = "Darwin" ]; then
echo "=== macOS Detected - Full Environment Check ===" && \
echo "Node.js: $(node -v 2>/dev/null || echo 'NOT INSTALLED')" && \
echo "Yarn: $(yarn -v 2>/dev/null || echo 'NOT INSTALLED')" && \
echo "Java: $(java -version 2>&1 | head -1 || echo 'NOT INSTALLED')" && \
echo "Go: $(go version 2>/dev/null || echo 'NOT INSTALLED')" && \
echo "Ruby: $(ruby -v 2>/dev/null || echo 'NOT INSTALLED')" && \
echo "CocoaPods: $(pod --version 2>/dev/null || echo 'NOT INSTALLED')" && \
echo "Xcode: $(xcodebuild -version 2>/dev/null | head -1 || echo 'NOT INSTALLED')"
else
echo "=== Non-macOS Detected - Partial Check ===" && \
echo "Node.js: $(node -v 2>/dev/null || echo 'NOT INSTALLED')" && \
echo "Yarn: $(yarn -v 2>/dev/null || echo 'NOT INSTALLED')" && \
echo "Java: $(java -version 2>&1 | head -1 || echo 'NOT INSTALLED')" && \
echo "Go: $(go version 2>/dev/null || echo 'NOT INSTALLED')" && \
echo "Note: iOS development requires macOS with Xcode, CocoaPods, Ruby"
fi
Create or regenerate a patch-package patch in this monorepo. Use when you edit anything under node_modules/ and need a persisted .patch, or when `npx patch-package <pkg>` fails with "Couldn't find any versions for ... matches ^x@x". Keywords: patch-package, patch a package, regenerate patch, resolutions error.
App-side OneKey Trade/Swap/Market guide for Swap core, Swap Pro, Market speed-swap, K-line/chart, token selectors, cold-start frame-by-frame validation, quote/build/send flows, history/status, provider channels, PrivateSend-like channels, stock-trading channels, limit/order flows, fees, slippage, ETA, and cross-module funding handoffs.
Creates a Pull Request from current changes for OneKey app-monorepo. Use when user wants to create PR, submit changes, or merge feature branch. Handles branch creation, commit, push, and PR creation with conversation context extraction for code review AI.
AI-agent-driven UI verification for OneKey. Use to actually drive the running app and confirm a visual/interactive change works — Electron desktop via Chrome DevTools Protocol (CDP) on port 9222 with playwright-core, and React Native (iOS/Android) via callstack agent-device. Triggers on "verify the UI", "drive the app", "screenshot the change", "check it on desktop/simulator", "CDP 9222", "agent-device", "UI 验证", "跑一下看看", "截图确认".
App-side OneKey DeFi guide for Earn, Borrow, Staking, vaults, lending, protocol integrations, ABI-backed operations, native/provider-backed operations, pending transactions, history, route handoffs, risk display, and DeFi regression review.
Use only for explicit OneKey Perps/Hyperliquid (`views/Perp`, ServiceHyperLiquid, perpetuals, 永续/合约, Perps trading). Covers orderbook/L2/BBO, TWAP, scale/TIF/trigger/reduce-only, Perps TradingView/K-line, Perps Relay deposit, token selector, positions/account state/PnL/funding/margin/liquidation. Exclude generic Swap/Market/TradingView; Swap Relay quote/status/pending/requestId alone is not enough unless Perps deposit/Hyperliquid/`views/Perp`/`usePerpDeposit`/`fetchPerpDeposit*`/`perpsDepositOrderAtom` is explicit.