קל לארגן דפים בעזרת אוספים
אפשר לשמור ולסווג תוכן על סמך ההעדפות שלך.
בדף הזה מוסבר איך ליצור את האפליקציה הראשונה ל-Wear OS באמצעות תבנית מ-Android Studio. באפליקציה מוצגות הדרכים השונות להצגת מידע במבט חטוף במכשירי Wear OS, ומוצגות כמה שיטות מומלצות לפיתוח אפליקציות בפלטפורמה.
אחרי שמורידים ומתקינים את הגרסה העדכנית של Android Studio, משלימים את האשף 'פרויקט חדש':
פותחים את Android Studio ועוברים אל File > New > New Project (קובץ > חדש > פרויקט חדש). יופיע החלון New Project.
בחלונית תבניות, בוחרים באפשרות Wear OS. לאחר מכן, בחלונית הראשית, בוחרים באפשרות Empty Wear App (אפליקציית Wear ריקה).
נותנים שם לפרויקט ולוחצים על סיום. Android Studio מוריד את התלות הנדרשת ובונה את הגרסה הראשונית של הפרויקט.
עוברים אל Tools > SDK Manager (כלים > כלי SDK), לוחצים על Show Package Details (הצגת פרטי החבילה) ומתקינים את החבילות הבאות:
Android 15.0 (VanillaIceCream) (רמת API 35-ext15), שכוללת את תמונת המערכת של Wear OS 5.1 ARM 64 v8a ואת תמונת המערכת של Wear OS 5.1 Intel x86 Atom_64.
Android 14.0 (UpsideDownCake) (רמת API 34), שכולל את
תמונת המערכת Wear OS 5 ARM 64 v8a ואת
תמונת המערכת Wear OS 5 Intel x86 Atom_64.
Android 13.0 ("Tiramisu") (רמת API 33), שכוללת את תמונת המערכת Wear OS 4 ARM 64 v8a ואת תמונת המערכת Wear OS 4 Intel x86 Atom_64.
כדי לסגור את SDK Manager, לוחצים על OK.
עכשיו אפשר להריץ את האפליקציה הראשונה ב-Wear OS.
הפעלת אפליקציה באמולטור
הדרך הכי קלה להריץ את אפליקציית Wear OS הראשונה היא להגדיר אמולטור.
הגדרת אמולטור
כדי להגדיר אמולטור ב-Android Studio, מבצעים את השלבים הבאים:
ב-SDK Manager, פותחים את הכרטיסייה SDK Tools. מוודאים שמותקנת במכשיר הגרסה העדכנית ביותר של Android SDK Platform-Tools. סוגרים את SDK Manager.
עוברים אל כלים > המרכז לניהול מכשירים.
לוחצים על יצירה (+). מופיע האשף Virtual Device Configuration (הגדרת מכשיר וירטואלי).
בחלונית Category, בוחרים באפשרות Wear OS ובוחרים פרופיל חומרה, כמו Wear OS Small Round. לוחצים על הבא.
לתמונות מערכת שמשמשות מחוץ לסין, בוחרים את שם הגרסה UpsideDownCake. הגרסה הזו מיועדת ל-Android 14.0 (Wear OS 5). כדי להשתמש בתמונות מערכת בסין, בוחרים את שם הגרסה R. הגרסה הזו מיועדת ל-Android 11.0 (Wear OS 3). אם עדיין לא התקנתם תמונת מערכת של Wear OS 5 שתואמת להגדרת המכשיר, לוחצים על הורדה לצד שם הגרסה כדי להוריד אותה. לוחצים על הבא.
הערה: תמונות מערכת לאמולטור של Wear OS כוללות הודעות על קובצי צד שלישי וקוד מקור. כדי לראות את ההודעות לגבי צד שלישי עבור תמונת מערכת מסוימת, פותחים את הקובץ NOTICE.txt, שנמצא באחת מהספריות הבאות:
$ANDROID_HOME/system-images/android-API_VERSION_NUMBER/android-wear/ABI
לשימוש באמולטורים מחוץ לסין.
עוברים אל הפעלה > בחירת מכשיר. בוחרים את האמולטור שיצרתם.
בסרגל הכלים של Android Studio, לוחצים על Run (הפעלה)
. האמולטור מתחיל ופותח את האפליקציה.
אחרי כמה רגעים, אמורה להופיע ההודעה 'שלום...' באמולטור.
בדיקת אודיו ב-Bluetooth באמצעות האמולטור
במערכות הפעלה עם Wear OS בגרסה 4 ואילך, האמולטור תומך ב-Bluetooth מדומה, שמאפשר לכם לבדוק אודיו ב-Bluetooth בכמה תרחישי שימוש.
תמונות מערכת מהזמן האחרון תומכות רק בארכיטקטורות של 64 ביט
תמונות המערכת של האמולטור ל-Wear OS 4 ומעלה תומכות רק בארכיטקטורות 64 ביט הבאות: x86-64 ו-arm64-v8a. אם אתם יודעים או חושדים שהאפליקציה שלכם משתמשת בקוד מקורי (שלא נכתב בשפות התכנות Kotlin או Java), אתם צריכים לוודא שהאפליקציה כוללת ספריות מקוריות של 32 ביט ו-64 ביט.
הפעלת האפליקציה וניפוי הבאגים שלה בשעון אמיתי מאפשרים להעריך טוב יותר את חוויית המשתמש הכוללת. זה חשוב במיוחד אם האפליקציה מסתמכת על חומרה ספציפית, כמו חיישנים או GPU.
כדי להריץ אפליקציה בשעון פיזי, צריך להכין את המכשיר לבדיקה ואז לחבר אותו למחשב הפיתוח.
הכנת השעון לבדיקה
כדי להכין את השעון לבדיקה, צריך להפעיל ניפוי באגים באמצעות ADB. לשם כך, פועלים לפי השלבים הבאים.
פותחים את תפריט ההגדרות בשעון.
גוללים לתחתית התפריט. אם לא מופיע הפריט אפשרויות למפתחים, צריך לבצע את השלבים הבאים. אם לא, ממשיכים לשלב הבא.
מקישים על מערכת > מידע או על מערכת > מידע > גרסאות.
מחפשים את הפריט מספר Build ומקישים עליו שבע פעמים. אם השעון מוגן באמצעות קוד אימות או קו ביטול נעילה, מזינים אותו כשמתבקשים לעשות זאת.
בתפריט הגדרות, מקישים על אפשרויות למפתחים.
מפעילים את האפשרות ניפוי באגים באמצעות ADB.
חיבור השעון למכונת פיתוח
בחלק מהשעונים אפשר להתחבר באמצעות USB. אחרים דורשים חיבור אלחוטי.
הגדרת חיבור קווי באמצעות USB
כדי לחבר את השעון, פועלים לפי השלבים הבאים:
מחברים את השעון למחשב הפיתוח באמצעות כבל USB.
בסמארטפון, מפעילים את האפשרות אפשר תמיד מהמחשב הזה ומקישים על אישור.
אם תרחיש הבדיקה של האפליקציה שלכם תלוי בגרסה ספציפית של Wear OS, אתם יכולים להפעיל תמונה של תוכנה בשעונים שתומכים בחיבור נתונים באמצעות USB (חיבור קווי). לדוגמה, אפשר להפעיל תמונת מערכת של הגדרות המקוריות או תמונת מערכת מלאה של OTA במכשיר Google Pixel Watch 3 או Google Pixel Watch 2.
פותחים את האפליקציה בשעון
עוברים אל הפעלה > בחירת מכשיר. בוחרים את השעון שמחובר למחשב.
בסרגל הכלים של Android Studio, לוחצים על Run (הפעלה)
. האמולטור מתחיל ופותח את האפליקציה.
אחרי כמה רגעים, ההודעה 'שלום...' אמורה להופיע בשעון.
דוגמאות התוכן והקוד שבדף הזה כפופות לרישיונות המפורטים בקטע רישיון לתוכן. Java ו-OpenJDK הם סימנים מסחריים או סימנים מסחריים רשומים של חברת Oracle ו/או של השותפים העצמאיים שלה.
עדכון אחרון: 2025-07-27 (שעון UTC).
[[["התוכן קל להבנה","easyToUnderstand","thumb-up"],["התוכן עזר לי לפתור בעיה","solvedMyProblem","thumb-up"],["סיבה אחרת","otherUp","thumb-up"]],[["חסרים לי מידע או פרטים","missingTheInformationINeed","thumb-down"],["התוכן מורכב מדי או עם יותר מדי שלבים","tooComplicatedTooManySteps","thumb-down"],["התוכן לא עדכני","outOfDate","thumb-down"],["בעיה בתרגום","translationIssue","thumb-down"],["בעיה בדוגמאות/בקוד","samplesCodeIssue","thumb-down"],["סיבה אחרת","otherDown","thumb-down"]],["עדכון אחרון: 2025-07-27 (שעון UTC)."],[],[],null,["# Create and run an app on Wear OS\n\nThis page provides a guide for you to build your first app for Wear OS, using a\ntemplate from Android Studio. The app showcases the different ways to view\ninformation at a glance on Wear OS devices, and introduces some best practices\nfor developing apps on the platform.\n\nThis guide builds upon some prior knowledge about the Android platform and the\n[Android Studio IDE](/studio). If you're completely new to Android, [create an app\nusing this codelab](/codelabs/basic-android-kotlin-compose-first-app#1). To learn more about Android Studio's capabilities, visit\nthe [Meet Android Studio](/studio/intro) page.\n| **Note:** To use the latest system images that are available for the emulator, install Android Studio Hedgehog or later.\n\nCreate a Wear OS app\n--------------------\n\nAfter you download and install the latest version of Android Studio, complete\nthe \"new project\" wizard:\n\n1. Open Android Studio, and then go to **File \\\u003e New \\\u003e New Project** . The **New Project** window appears.\n2. In the **Templates** pane, select **Wear OS** . Then, in the main pane, select **Empty Wear App**.\n3. Name your project, and then click **Finish**. Android Studio downloads the necessary dependencies and builds the initial version of your project.\n4. Go to [**Tools \\\u003e SDK Manager**](/studio/intro/update#sdk-manager), click **Show Package Details**, and\n install the following packages:\n\n - **Android 15.0 (\"VanillaIceCream\")** (API level 35-ext15), which includes the **Wear OS 5.1 ARM 64 v8a System Image** and the **Wear OS 5.1 Intel x86 Atom_64 System Image**.\n - **Android 14.0 (\"UpsideDownCake\")** (API level 34), which includes the **Wear OS 5 ARM 64 v8a System Image** and the **Wear OS 5 Intel x86 Atom_64 System Image**.\n - **Android 13.0 (\"Tiramisu\")** (API level 33), which includes the **Wear OS 4 ARM 64 v8a System Image** and the **Wear OS 4 Intel x86 Atom_64\n System Image**.\n\n | **Note:** The latest stable version of Wear OS, Wear OS 5.1, is based on Android 15.\n\n To close the SDK Manager, click **OK**.\n\nYou're now ready to run your first app on Wear OS.\n| **Note:** By default, the **New Project** wizard creates a standalone, independent Wear OS app that doesn't need to connect to another device in order to run. \n|\n| A Wear OS app should work independently of a phone app, giving users the greatest flexibility in their choice of phones. If your app's experience or complexity requires you to connect to a phone, see the guide on how to [connect\n| a watch to a phone](/training/wearables/get-started/connect-phone).\n\nRun an app on the emulator\n--------------------------\n\nThe easiest way to run your first Wear OS app is to configure an emulator.\n| **Note:** If you plan to make your Wear OS apps available in China, also visit the [Create Wear OS apps for China](/training/wearables/apps/creating-app-china) page.\n\n### Configure an emulator\n\nTo configure an emulator in Android Studio, complete the following steps:\n\n1. In the SDK Manager, Open the **SDK Tools** tab. Confirm that you have the latest version of **Android SDK Platform-Tools**. Close the SDK Manager.\n2. Go to **Tools \\\u003e Device Manager**.\n3. Select **Create (+)** . The **Virtual Device Configuration** wizard appears.\n4. In the **Category** pane, select **Wear OS** and choose a hardware profile, such as **Wear OS Small Round** . Click **Next**.\n5. For system images used outside of China, select the **UpsideDownCake**\n release name. This release targets Android 14.0 (Wear OS 5). For\n system images used in China, select the **R** release name. This release\n targets Android 11.0 (Wear OS 3). If you don't already have a Wear OS 5\n system image installed that matches your device definition, click\n **Download** next to the **Release Name** to get it. Click **Next**.\n\n **Note:** System images for the Wear OS emulator include notices of\n third-party files and source code. You can view third-party notices for a\n particular system image by opening the `NOTICE.txt` file, which\n is in one of the following directories:\n - `$ANDROID_HOME/system-images/android-`\u003cvar translate=\"no\"\u003eAPI_VERSION_NUMBER\u003c/var\u003e`/android-wear/`\u003cvar translate=\"no\"\u003eABI\u003c/var\u003e for emulators used outside of China.\n - `$ANDROID_HOME/system-images/android-`\u003cvar translate=\"no\"\u003eAPI_VERSION_NUMBER\u003c/var\u003e`/android-wear-cn/`\u003cvar translate=\"no\"\u003eABI\u003c/var\u003e for emulators used in China.\n6. You can keep the default value for all the settings on this screen, unless\n you want to customize your emulator. Click **Finish**.\n\nFor more information about using emulators, see the guide about how to [run apps\non the Android Emulator](/studio/run/emulator).\n\n### Open the app in the emulator\n\n1. Go to **Run \\\u003e Select Device**. Choose the emulator that you just created.\n2. In the Android Studio toolbar, click **Run** . The emulator starts and opens your app.\n3. After a few moments, you should see a \"Hello...\" message in the emulator.\n\n### Test Bluetooth audio using the emulator\n\nOn system images the run Wear OS 4 or higher, the emulator supports emulated\nBluetooth, which lets you [test Bluetooth audio](/training/wearables/apps/test-bluetooth-audio) across several use cases.\n\n### Recent system images only support 64-bit architectures\n\nThe emulator system images for Wear OS 4 and higher only support these 64-bit\narchitectures: `x86-64` and `arm64-v8a`. If you know or suspect that your app\nuses native code (that isn't written in the Kotlin or Java programming\nlanguages), check that your app includes both 32-bit and 64-bit native\nlibraries.\n\nLearn more about how to [support 64-bit architectures](/google/play/requirements/64-bit).\n\nRun an app on a physical watch (optional)\n-----------------------------------------\n\nRunning and debugging your app on an actual watch lets you better evaluate the\ntotal user experience. This is particularly important if your app relies on\nspecific hardware, such as sensors or a GPU.\n\nTo run an app on a physical watch, prepare the device for testing, and then\nconnect it to your development machine.\n\n### Prepare watch for testing\n\nTo prepare your watch for testing, enable ADB debugging by completing the\nfollowing steps.\n\n1. On the watch, open the **Settings** menu.\n2. Go to the bottom of the menu. If no **Developer options** item appears, complete the following sub-steps. Otherwise, continue to the next step.\n 1. Tap **System \\\u003e About** or **System \\\u003e About \\\u003e Versions**.\n 2. Find the **Build number** item and tap it seven times. If your watch is protected by a PIN or pattern, enter it when prompted to do so.\n3. From the **Settings** menu, tap **Developer options**.\n4. Enable the **ADB debugging** option.\n\n### Connect watch to development machine\n\nSome watches let you connect over USB. Others require a wireless connection.\n\n#### Set up a wired connection over USB\n\nConnect the watch using the following steps:\n\n1. Using a USB cable, connect the watch to your development machine.\n2. On the watch, enable **Always allow from this computer** , and then tap **OK**.\n\n#### Set up a wireless connection\n\nIf your watch lacks a USB port, learn how to [connect a watch using Wi-Fi or\nBluetooth](/training/wearables/apps/debugging).\n\n### Install a specific version of Wear OS (optional)\n\nIf your app's test case depends on a specific version of Wear OS, you can flash\na software image onto watches that support a USB (wired) data connection. For\nexample, you can flash a [factory image](https://developers.google.com/android/images-watch) or a [full OTA image](https://developers.google.com/android/ota-watch)\nonto a Google Pixel Watch 3 or Google Pixel Watch 2 device.\n\n### Open the app on the watch\n\n1. Go to **Run \\\u003e Select Device**. Choose the watch that is connected to your machine.\n2. In the Android Studio toolbar, click **Run** . The emulator starts and opens your app.\n3. After a few moments, you should see a \"Hello...\" message appear on the watch.\n\nRecommended for you\n-------------------\n\n- Note: link text is displayed when JavaScript is off\n- [Integrate custom C/C++ build systems using Ninja (experimental)](/build/cxx-ninja)\n- [Vulkan validation layers on Android](/ndk/guides/graphics/validation-layer)\n- [Release notes](/training/wearables/versions/5/release-notes)"]]
. האמולטור מתחיל ופותח את האפליקציה.