تنظيم صفحاتك في مجموعات
يمكنك حفظ المحتوى وتصنيفه حسب إعداداتك المفضّلة.
تقدّم لك هذه الصفحة دليلاً لإنشاء تطبيقك الأول على Wear OS باستخدام نموذج من "استوديو Android". يعرض التطبيق الطرق المختلفة لعرض المعلومات
بسرعة على أجهزة Wear OS، ويقدّم بعض أفضل الممارسات
لتطوير التطبيقات على المنصة.
Android 15.0 (VanillaIceCream) (المستوى 35 لواجهة برمجة التطبيقات-ext15)، والذي يتضمّن
صورة نظام Wear OS 5.1 ARM 64 v8a و
صورة نظام Wear OS 5.1 Intel x86 Atom_64.
Android 14.0 ("UpsideDownCake") (المستوى 34 من واجهة برمجة التطبيقات)، والذي يتضمّن
صورة نظام Wear OS 5 ARM 64 v8a و
صورة نظام Wear OS 5 Intel x86 Atom_64
Android 13.0 ("Tiramisu") (المستوى 33 لواجهة برمجة التطبيقات)، والذي يتضمّن
صورة نظام Wear OS 4 ARM 64 v8a وصورة نظام Wear OS 4 Intel x86 Atom_64.
لإغلاق "أداة إدارة حزمة تطوير البرامج (SDK)"، انقر على حسنًا.
أنت الآن جاهز لتشغيل تطبيقك الأول على Wear OS.
تشغيل تطبيق على المحاكي
أسهل طريقة لتشغيل تطبيق Wear OS الأول هي إعداد محاكي.
إعداد محاكي
لإعداد محاكي في Android Studio، أكمِل الخطوات التالية:
في "مدير حزمة تطوير البرامج (SDK)"، افتح علامة التبويب أدوات حزمة تطوير البرامج (SDK). تأكَّد من أنّ لديك أحدث إصدار من أدوات النظام الأساسي لحزمة تطوير البرامج (SDK) لنظام التشغيل Android. أغلِق "مدير حزمة تطوير البرامج (SDK)".
انتقِل إلى الأدوات > إدارة الأجهزة.
انقر على إنشاء (+). سيظهر معالج إعداد الجهاز الافتراضي.
في لوحة الفئة، اختَر 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_HOME/system-images/android-API_VERSION_NUMBER/android-wear-cn/ABI
للمحاكيات المستخدَمة في الصين
يمكنك الاحتفاظ بالقيمة التلقائية لجميع الإعدادات في هذه الشاشة، إلا إذا أردت تخصيص المحاكي. انقر على إنهاء.
انتقِل إلى تشغيل > اختيار جهاز. اختَر المحاكي الذي أنشأته للتو.
في شريط أدوات Android Studio، انقر على تشغيل. يبدأ المحاكي ويفتح تطبيقك.
بعد لحظات قليلة، من المفترض أن تظهر لك الرسالة "مرحبًا..." في المحاكي.
اختبار صوت البلوتوث باستخدام المحاكي
على صور النظام التي تعمل بنظام التشغيل Wear OS 4 أو الإصدارات الأحدث، يتيح المحاكي استخدام البلوتوث المحاكى، ما يسمح لك باختبار الصوت عبر البلوتوث في العديد من حالات الاستخدام.
لا تتوافق صور النظام الحديثة إلا مع بنى 64 بت
لا تتوافق صور نظام المحاكي لإصدار Wear OS 4 والإصدارات الأحدث إلا مع بنى 64 بت التالية: x86-64 وarm64-v8a. إذا كنت تعلم أو تشك في أنّ تطبيقك يستخدم رمزًا أصليًا (غير مكتوب بلغتَي البرمجة Kotlin أو Java)، تأكَّد من أنّ تطبيقك يتضمّن مكتبات مجمَّعة من رموز برمجية أصلية بنظامَي 32 بت و64 بت.
يتيح لك تشغيل تطبيقك وتصحيح أخطائه على ساعة فعلية تقييم تجربة المستخدم بشكل أفضل. ويكون ذلك مهمًا بشكل خاص إذا كان تطبيقك يعتمد على أجهزة معيّنة، مثل أجهزة الاستشعار أو وحدة معالجة الرسومات.
لتشغيل تطبيق على ساعة فعلية، عليك إعداد الجهاز للاختبار، ثم ربطه بجهاز التطوير.
تجهيز الساعة للاختبار
لإعداد ساعتك للاختبار، فعِّل خيار "تصحيح الأخطاء عبر ADB" من خلال إكمال الخطوات التالية.
افتح قائمة الإعدادات على الساعة.
انتقِل إلى أسفل القائمة. إذا لم يظهر أي عنصر خيارات المطوّرين،
أكمِل الخطوات الفرعية التالية. بخلاف ذلك، انتقِل إلى الخطوة التالية.
انقر على النظام > لمحة أو النظام > لمحة > الإصدارات.
ابحث عن الخيار رقم الإصدار وانقر عليه سبع مرات. إذا كانت ساعتك محمية برقم تعريف شخصي أو نقش، أدخِلهما عندما يُطلب منك ذلك.
من قائمة الإعدادات، انقر على خيارات المطوّرين.
فعِّل الخيار تصحيح الأخطاء عبر ADB.
ربط الساعة بجهاز التطوير
تتيح لك بعض الساعات الاتصال عبر USB. وتتطلّب بعضها الآخر اتصالاً لاسلكيًا.
إعداد اتصال سلكي عبر USB
اربط الساعة باتّباع الخطوات التالية:
باستخدام كابل USB، وصِّل الساعة بجهاز التطوير.
على الساعة، فعِّل الخيار السماح دائمًا من هذا الكمبيوتر، ثم انقر على حسنًا.
إذا كانت حالة الاختبار في تطبيقك تعتمد على إصدار معيّن من Wear OS، يمكنك نقل صورة برنامج إلى الساعات التي تتيح اتصال بيانات عبر USB (سلكي). على سبيل المثال، يمكنك تثبيت صورة المصنع أو صورة OTA الكاملة على ساعة Google Pixel Watch 3 أو Google Pixel Watch 2.
افتح التطبيق على الساعة
انتقِل إلى تشغيل > اختيار جهاز. اختَر الساعة المرتبطة بجهازك.
في شريط أدوات Android Studio، انقر على تشغيل. يبدأ المحاكي ويفتح تطبيقك.
بعد لحظات قليلة، من المفترض أن تظهر رسالة "مرحبًا..." على الساعة.
أفلام مُقترَحة لك
ملاحظة: يتم عرض نص الرابط عندما تكون JavaScript غير مفعّلة
يخضع كل من المحتوى وعيّنات التعليمات البرمجية في هذه الصفحة للتراخيص الموضحّة في ترخيص استخدام المحتوى. إنّ Java وOpenJDK هما علامتان تجاريتان مسجَّلتان لشركة Oracle و/أو الشركات التابعة لها.
تاريخ التعديل الأخير: 2025-07-27 (حسب التوقيت العالمي المتفَّق عليه)
[null,null,["تاريخ التعديل الأخير: 2025-07-27 (حسب التوقيت العالمي المتفَّق عليه)"],[],[],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)"]]
. يبدأ المحاكي ويفتح تطبيقك.