בטא בקרוב. הפיצ׳ר עדיין בפיתוח, ולכן שמות ופרטים עשויים להשתנות לפני השחרור.

תצוגה מקדימה במובייל

פתחו את האפליקציה בסימולטורים של iOS, באמולטורים של Android ובטלפונים אמיתיים מתוך App Preview, עם מסגרות מכשיר וקוד QR.

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

App Preview ב-Ingot עם פאנל Devices: סימולטורים של iOS, אייפון מצומד, אמולטור Android ו-Pixel ב-USB, החנות במסגרת Pixel וקוד QR של כתובת ה-LANApp Preview ב-Ingot עם פאנל Devices: סימולטורים של iOS, אייפון מצומד, אמולטור Android ו-Pixel ב-USB, החנות במסגרת Pixel וקוד QR של כתובת ה-LAN
App Preview ב-Ingot עם פאנל Devices: סימולטורים של iOS, אייפון מצומד, אמולטור Android ו-Pixel ב-USB, החנות במסגרת Pixel וקוד QR של כתובת ה-LAN

הפעלה

את Mobile preview קל למצוא בשלוש דרכים, כמו כל פיצ'ר אופציונלי:

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

פאנל Devices

הפאנל מציג את מה שרץ, מקובץ, ומתרענן כל כמה שניות כל עוד הוא פתוח:

קבוצהנמצא בעזרתמה מוצג
iOS Simulatorsxcrun simctl list devicesסימולטורים של iPhone ו-iPad שהופעלו, עם גרסת ה-iOS
iPhone and iPadxcrun devicectl list devices (‏Xcode 15 ומעלה)טלפונים וטאבלטים שמצומדים ל-Mac הזה, ב-USB או ברשת
Android Emulatorsadb devices -lאמולטורים שרצים
Android devicesadb 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 נותן לכל מכשיר כתובת שהוא יכול לפתוח:

מכשירהכתובת שהוא מקבלאיך היא נפתחת
סימולטור iOSlocalhost כמו שהוא (הסימולטור חולק את הרשת של ה-Mac)xcrun simctl openurl
אמולטור Android‏10.0.2.2, השם של המחשב הזה בתוך האמולטורadb shell am start -a android.intent.action.VIEW
iPhone או iPadכתובת ה-LAN של המחשב, ב-Safarixcrun 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:

פרויקטהאפליקציה נפתחת ב-כתובת
ExpoExpo Goexp://<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 נכנס ישר לאפליקציה.

פאנל Devices כש-Metro נמצא: כפתורי App ו-Open בכל מכשיר, וקוד ה-QR על Expo Go עם כתובת exp://פאנל Devices כש-Metro נמצא: כפתורי App ו-Open בכל מכשיר, וקוד ה-QR על Expo Go עם כתובת exp://
פאנל Devices כש-Metro נמצא: כפתורי App ו-Open בכל מכשיר, וקוד ה-QR על Expo Go עם כתובת exp://

מסגרות מכשיר

כש-Mobile preview פועל, גדלי טלפון וטאבלט ב-App Preview מקבלים מסגרת: אייפון עם האי שלו, iPhone SE עם כפתור בית, Pixel עם מצלמה בחור במסך, או טאבלט. סיבוב מסובב גם את המסגרת. כפתור המסגרת ליד Devices מציג או מסתיר מסגרות, ו-הגדרות › כלים › Mobile preview › Device frames שומר את הבחירה. גדלי מחשב ו-Responsive לא מקבלים מסגרת.

כש-Xcode או adb חסרים

הפאנל מציג מה לא נמצא ואיך להתקין אותו, וממשיך לעבוד עם מה שיש:

חסרmacOSWindows ו-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.

פאנל Devices בלי Xcode ובלי adb: אין מכשירים, והוראות התקנה ל-iOS Simulators, ‏iPhone and iPad ו-Androidפאנל Devices בלי Xcode ובלי adb: אין מכשירים, והוראות התקנה ל-iOS Simulators, ‏iPhone and iPad ו-Android
פאנל Devices בלי Xcode ובלי adb: אין מכשירים, והוראות התקנה ל-iOS Simulators, ‏iPhone and iPad ו-Android

קיצורי מקלדת

פעולהmacOSWindows / Linux
Mobile Preview: Open Devices⌘⌥⇧HomeCtrl+Alt+Shift+Home
Mobile Preview: Turn On or Off⌘⌥⇧MCtrl+Alt+Shift+M
Open App on Device…⌘⌥OCtrl+Alt+O
Show QR Code for Phone⌘⌥QCtrl+Alt+Q
Connect Android Phone over Wi-Fi…⌘⌥⇧ACtrl+Alt+Shift+A
Refresh Devices⌘⌥⇧RCtrl+Alt+Shift+R
Toggle Device Frames⌘⌥FCtrl+Alt+F

כל הקיצורים חוץ מ-Open Devices עובדים כש-App Preview בפוקוס. כולם נמצאים ב-Find Action ובהגדרות מפת המקשים.

הגדרות

הגדרהברירת מחדלמה היא עושה
ingot.appPreview.mobile.enabledfalseMobile preview (הגדרות › פיצ'רים): פאנל Devices, מסגרות המכשיר ומספר המכשירים בשורת הסטטוס
ingot.appPreview.mobile.deviceFramestrueDevice frames: מסגרת iPhone, ‏iPhone SE, ‏Pixel או טאבלט סביב גדלי טלפון וטאבלט
ingot.appPreview.mobile.refreshInterval3Refresh devices every (seconds): כל כמה זמן פאנל Devices הפתוח סורק, 1 עד 60
ingot.appPreview.mobile.lanAddressריקLAN address: הכתובת שבה טלפונים מגיעים למחשב, למכשירים אמיתיים ולקוד ה-QR; ריק משתמש בכתובת ה-IPv4 של ה-Wi-Fi או ה-Ethernet
ingot.suggestions.enabledtrueSuggest 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.