תצוגה מקדימה במובייל
פתחו את האפליקציה בסימולטורים של iOS, באמולטורים של Android ובטלפונים אמיתיים מתוך App Preview, עם מסגרות מכשיר וקוד QR.
Beta Mobile preview הוא פיצ'ר אופציונלי של התצוגה המקדימה של האפליקציה, והוא כבוי עד שמפעילים אותו. הוא מוסיף פאנל Devices ליד הדף: כל סימולטור, אמולטור וטלפון שרץ או מחובר, כפתור שפותח בכל אחד מהם את הדף שאתם רואים, את אפליקציית React Native או Expo שלכם ב-Expo Go או ב-development build, וקוד QR של הכתובת שטלפון ב-Wi-Fi שלכם יכול לפתוח.


הפעלה
את Mobile preview קל למצוא בשלוש דרכים, כמו כל פיצ'ר אופציונלי:
- הצעה בצ'אט. כשהפרויקט הוא אפליקציית React Native, Expo, Capacitor, Ionic או Cordova, כשסימולטור, אמולטור או טלפון רץ, או כששואלים על טלפונים, טאבלטים או עיצוב רספונסיבי, כרטיס קטן מעל תיבת הצ'אט מציע Enable Mobile preview. × מסתיר אותו לתמיד.
- הגדרות › פיצ'רים › Mobile preview. מתג הפעלה. כיבוי מסתיר את פאנל Devices ואת מסגרות המכשיר.
- כפתור Mobile בשורת הסטטוס ו-Devices בסרגל של App Preview. לחיצה אחת מפעילה את Mobile preview ופותחת את פאנל Devices. כשהפיצ'ר פועל, שורת הסטטוס מראה כמה מכשירים מוכנים ("2 devices").




פאנל Devices
הפאנל מציג את מה שרץ, מקובץ, ומתרענן כל כמה שניות כל עוד הוא פתוח:
| קבוצה | נמצא בעזרת | מה מוצג |
|---|---|---|
| iOS Simulators | xcrun simctl list devices | סימולטורים של iPhone ו-iPad שהופעלו, עם גרסת ה-iOS |
| iPhone and iPad | xcrun devicectl list devices (Xcode 15 ומעלה) | טלפונים וטאבלטים שמצומדים ל-Mac הזה, ב-USB או ברשת |
| Android Emulators | adb devices -l | אמולטורים שרצים |
| Android devices | adb devices -l | טלפונים וטאבלטים ב-USB או ב-Wi-Fi; מכשירים לא מאושרים או מנותקים מוצגים בעמעום |
- לחיצה על מכשיר מציגה את הדף בגודל שלו: App Preview עובר לגודל הקרוב ביותר (iPhone SE, iPhone 15 Pro, Pro Max, Pixel 8, Galaxy S23, iPad mini או iPad Pro) ומצייר את המסגרת שלו.
- Open שולח את הדף שאתם רואים למכשיר.
- App פותח במקום זאת את אפליקציית React Native או Expo (ראו React Native ו-Expo).
- Refresh סורק מחדש עכשיו. שורה מתחת לרשימה מספרת מה קרה, למשל "Opened on iPhone 15 Pro (Simulator)".
מה כל מכשיר פותח
App Preview מציג localhost, שרק המחשב הזה מגיע אליו. Ingot נותן לכל מכשיר כתובת שהוא יכול לפתוח:
| מכשיר | הכתובת שהוא מקבל | איך היא נפתחת |
|---|---|---|
| סימולטור iOS | localhost כמו שהוא (הסימולטור חולק את הרשת של ה-Mac) | xcrun simctl openurl |
| אמולטור Android | 10.0.2.2, השם של המחשב הזה בתוך האמולטור | adb shell am start -a android.intent.action.VIEW |
| iPhone או iPad | כתובת ה-LAN של המחשב, ב-Safari | xcrun devicectl device process launch --payload-url |
| טלפון או טאבלט Android | כתובת ה-LAN של המחשב, בדפדפן ברירת המחדל | adb shell am start -a android.intent.action.VIEW |
מכשירים אמיתיים צריכים להיות באותה רשת Wi-Fi כמו המחשב, ושרת הפיתוח צריך להאזין בכל הכתובות ולא רק ב-localhost. כשהוא מאזין רק ב-localhost, הפאנל אומר זאת. ב-Vite הריצו npm run dev -- --host; ב-Next.js next dev -H 0.0.0.0.
Android ב-Wi-Fi
הפעילו בטלפון אפשרויות מפתחים › ניפוי באגים אלחוטי, הקלידו את הכתובת שלו ב-Android over Wi-Fi (למשל 192.168.1.40:5555; פורט 5555 אם לא מציינים) ולחצו Connect. Ingot מריץ adb connect והטלפון מצטרף לרשימה. Connect Android Phone over Wi-Fi… ב-Find Action עושה את אותו הדבר.
קוד QR לטלפון
Real phone בתחתית הפאנל מציג קוד QR של כתובת ה-LAN של הדף. סרקו אותו במצלמת הטלפון כדי לפתוח שם את הדף. הכתובת מופיעה מתחת לקוד עם כפתור העתקה. הקוד תמיד כהה על רקע בהיר, בכל ערכת נושא, כדי שמצלמות יוכלו לקרוא אותו.
Ingot משתמש בכתובת ה-IPv4 של ה-Wi-Fi או ה-Ethernet. אם היא לא נכונה (VPN, כמה רשתות), הגדירו הגדרות › כלים › Mobile preview › LAN address.
React Native ו-Expo
כשהפרויקט משתמש ב-React Native או ב-Expo ו-Metro רץ (בפורט 8081 או בכל פורט מקומי שה-/status שלו עונה packager-status:running), הפאנל מציג Metro on :8081 · Expo · opens in Expo Go ולכל מכשיר יש כפתור App:
| פרויקט | האפליקציה נפתחת ב- | כתובת |
|---|---|---|
| Expo | Expo Go | exp://<host>:<port> |
Expo עם expo-dev-client ו-scheme ב-app.json | ה-development build שלכם | <scheme>://expo-development-client/?url=… |
| React Native בלי Expo | האפליקציה המותקנת (bundle id מ-app.json או מפרויקט ה-Xcode, חבילה מ-android/app/build.gradle) | ב-Android קודם מורץ adb reverse כדי שהאפליקציה תמצא את Metro ב-localhost |
סימולטורים משתמשים ב-localhost, אמולטור Android ב-10.0.2.2 וטלפונים בכתובת ה-LAN. כש-Metro רץ, Web ו-Expo Go (או Dev build) מעל קוד ה-QR מחליפים בין כתובת הדף לכתובת האפליקציה, כך שטלפון עם Expo Go נכנס ישר לאפליקציה.


מסגרות מכשיר
כש-Mobile preview פועל, גדלי טלפון וטאבלט ב-App Preview מקבלים מסגרת: אייפון עם האי שלו, iPhone SE עם כפתור בית, Pixel עם מצלמה בחור במסך, או טאבלט. סיבוב מסובב גם את המסגרת. כפתור המסגרת ליד Devices מציג או מסתיר מסגרות, ו-הגדרות › כלים › Mobile preview › Device frames שומר את הבחירה. גדלי מחשב ו-Responsive לא מקבלים מסגרת.
כש-Xcode או adb חסרים
הפאנל מציג מה לא נמצא ואיך להתקין אותו, וממשיך לעבוד עם מה שיש:
| חסר | macOS | Windows ו-Linux |
|---|---|---|
| סימולטורים של iOS | התקינו Xcode מה-App Store, פתחו אותו פעם אחת והריצו sudo xcode-select -s /Applications/Xcode.app | סימולטורים של iOS דורשים Mac עם Xcode |
| iPhone ו-iPad | Xcode 15 ומעלה, עם הטלפון מצומד ב-Xcode › Window › Devices and Simulators | Mac עם Xcode |
| Android (adb) | התקינו Android Studio (כולל adb), או brew install --cask android-platform-tools | התקינו Android Studio או Android SDK Platform-Tools |
Ingot מחפש את adb ב-PATH, ב-ANDROID_HOME או ANDROID_SDK_ROOT, בתיקיית ה-SDK של Android Studio וב-Homebrew. כדי להשתמש בעותק אחר, הגדירו את INGOT_ADB_BIN (או INGOT_XCRUN_BIN) לנתיב המלא שלו לפני שפותחים את Ingot.


קיצורי מקלדת
| פעולה | macOS | Windows / Linux |
|---|---|---|
| Mobile Preview: Open Devices | ⌘⌥⇧Home | Ctrl+Alt+Shift+Home |
| Mobile Preview: Turn On or Off | ⌘⌥⇧M | Ctrl+Alt+Shift+M |
| Open App on Device… | ⌘⌥O | Ctrl+Alt+O |
| Show QR Code for Phone | ⌘⌥Q | Ctrl+Alt+Q |
| Connect Android Phone over Wi-Fi… | ⌘⌥⇧A | Ctrl+Alt+Shift+A |
| Refresh Devices | ⌘⌥⇧R | Ctrl+Alt+Shift+R |
| Toggle Device Frames | ⌘⌥F | Ctrl+Alt+F |
כל הקיצורים חוץ מ-Open Devices עובדים כש-App Preview בפוקוס. כולם נמצאים ב-Find Action ובהגדרות מפת המקשים.
הגדרות
| הגדרה | ברירת מחדל | מה היא עושה |
|---|---|---|
ingot.appPreview.mobile.enabled | false | Mobile preview (הגדרות › פיצ'רים): פאנל Devices, מסגרות המכשיר ומספר המכשירים בשורת הסטטוס |
ingot.appPreview.mobile.deviceFrames | true | Device frames: מסגרת iPhone, iPhone SE, Pixel או טאבלט סביב גדלי טלפון וטאבלט |
ingot.appPreview.mobile.refreshInterval | 3 | Refresh devices every (seconds): כל כמה זמן פאנל Devices הפתוח סורק, 1 עד 60 |
ingot.appPreview.mobile.lanAddress | ריק | LAN address: הכתובת שבה טלפונים מגיעים למחשב, למכשירים אמיתיים ולקוד ה-QR; ריק משתמש בכתובת ה-IPv4 של ה-Wi-Fi או ה-Ethernet |
ingot.suggestions.enabled | true | Suggest features in chat: הכרטיסים שמציעים פיצ'רים אופציונליים |
ingot.suggestions.dismissed | [] | Suggestions you closed: mobile-preview נוסף כשסוגרים את הכרטיס שלו ב-× |
פרטיות
הכול רץ במחשב שלכם: Ingot קורא ל-xcrun ול-adb מקומית ורק קורא את רשימות המכשירים שלהם. שום דבר על המכשירים או על האפליקציה לא נשלח לשום מקום, וקוד ה-QR מכיל רק את הכתובת המקומית של שרת הפיתוח.
מהטרמינל
ingot preview mobile מציג את אותם מכשירים, ingot preview mobile open שולח שרת פיתוח למכשיר, ו-ingot preview qr מדפיס את קוד ה-QR בטרמינל:
ingot preview mobile # devices by group, Metro, and what is missing; --json
ingot preview mobile open "iPhone 15 Pro" 5173 # a device by id or name, a port or URL
ingot preview mobile open emulator-5554 --app # the Expo / React Native app
ingot preview mobile connect 192.168.1.40 # adb over Wi-Fi
ingot preview qr 5173 # QR code of the LAN address; --expo for Expo Go, --invert
כל האפשרויות נמצאות ב-CLI.