با مجموعهها، منظم بمانید
ذخیره و طبقهبندی محتوا براساس اولویتهای شما.
برای شروع توسعه برای Android XR، از آخرین ساخت Canary Android Studio استفاده کنید که شامل ابزارها و به‌روزرسانی‌های جدید بهینه‌سازی شده برای Android XR است.
ویژگی های جدید موجود در این نسخه از اندروید استودیو عبارتند از:
شبیه ساز اندروید XR
اضافه شدن پشتیبانی XR در Layout Inspector
قالب پروژه XR
سیستم مورد نیاز برای شبیه ساز اندروید XR
برای macOS:
سیستم عامل : macOS 13.3 یا بالاتر.
CPU/GPU : Apple Silicon (تراشه M1 یا جدیدتر)
RAM/VRAM : 16 گیگابایت یا بالاتر
برای ویندوز:
سیستم عامل : ویندوز 11 یا بالاتر.
CPU : اینتل نسل نهم یا جدیدتر، یا AMD Ryzen سری 1000 یا بالاتر.
رم : 16 گیگابایت یا بالاتر
پردازنده گرافیکی : NVIDIA GeForce سری 10 یا جدیدتر، یا AMD Radeon RX 5000 سری یا بالاتر.
VRAM : 8 گیگابایت یا بالاتر
تنظیمات BIOS : پسوندهای CPU VMX باید در بایوس رایانه شما فعال باشند
Android Studio را برای توسعه XR نصب و پیکربندی کنید
مراحل زیر را برای دانلود Android Studio و راه اندازی محیط توسعه خود انجام دهید:
مطمئن شوید که هر نسخه از Android Studio را که قبلاً نصب کرده اید، ببندید.
آخرین ساخت Canary Android Studio را دانلود کنید، آن را در مکان دلخواه خود استخراج کنید و برنامه را اجرا کنید.
دستورالعمل های نصب را در ویزارد دنبال کنید.
در گفتگوی خوش آمدید به Android Studio ، روی More Actions کلیک کنید و مدیر SDK را انتخاب کنید.
در صفحه Android SDK ، روی تب ابزار SDK کلیک کنید و ابزارهای زیر را برای نصب انتخاب کنید:
Android SDK Build-Tools
شبیه ساز اندروید
Android SDK Platform-Tools
Layout Inspector برای API 31 - 36
در زیر تب SDK Platforms ، موارد زیر را انجام دهید:
برای مشاهده تمام گزینه‌ها، کادر نمایش جزئیات بسته را انتخاب کنید.
تصویر سیستم Google Play XR ARM (macOS) یا Google Play XR Intel x86_64 (ویندوز) را انتخاب کنید.
برای انجام به‌روزرسانی‌ها روی Apply کلیک کنید و سپس روی OK کلیک کنید.
اجازه دهید تمام مراحل نصب کامل شود، سپس روی Finish کلیک کنید.
یک پروژه Android XR ایجاد کنید
برای ایجاد یک پروژه Android XR در Android Studio یا گسترش پروژه موجود به XR این مراحل را دنبال کنید.
در پنجره Welcome to Android Studio یکی از موارد زیر را انجام دهید:
اگر در حال ایجاد یک برنامه XR هستید، روی New Project کلیک کنید و به مرحله بعدی بروید.
اگر در حال فضاسازی یک برنامه موجود هستید، روی Open کلیک کنید تا پروژه خود را انتخاب کنید، سپس به مرحله بعدی بروید. ایجاد یک دستگاه مجازی اندروید جدید برای شبیه ساز اندروید. (برای کمک به فضاسازی برنامه موجود خود برای Android XR، برنامه Android خود را به صورت سه بعدی با XR بیاورید )
در دسته XR ، الگوی Basic Headset Activity را انتخاب کنید و روی Next کلیک کنید.
در صفحه بعدی می توانید نامی برای پروژه خود انتخاب کنید. می توانید تنظیمات پیش فرض را در جای خود رها کنید. سپس روی Finish کلیک کنید.
یک دستگاه مجازی اندروید جدید برای شبیه ساز اندروید ایجاد کنید
شبیه ساز Android XR یک نسخه تخصصی از شبیه ساز اندروید است که برای توسعه برنامه XR طراحی شده است. به شما امکان می دهد برنامه های واقعیت توسعه یافته (XR) خود را در محیط آشنای Android Studio تست و اشکال زدایی کنید.
برای استفاده از شبیه ساز Android XR، باید یک دستگاه مجازی جدید ایجاد کنید. برای انجام این کار مراحل زیر را دنبال کنید:
در Android Studio، روی Tools > AVD Manager کلیک کنید و دستورالعمل‌ها را برای ایجاد یک دستگاه مجازی Android (AVD) دنبال کنید.
در پنجره Add Device ، در قسمت Form Factor ، گزینه XR را انتخاب کنید، سپس XR Device را در لیست نام انتخاب کنید. روی Next کلیک کنید.
در تب بعدی ( پیکربندی دستگاه مجازی )، در قسمت System Image ، جدیدترین تصویر سیستم Android XR را که با سیستم شما سازگار است، انتخاب کنید.
روی Finish کلیک کنید.
برای شروع شبیه ساز، روی دکمه Run در Device Manager کلیک کنید.
شبیه ساز در یک پنجره جداگانه باز می شود.
برای راه اندازی برنامه خود در شبیه ساز، روی نماد Run در Android Studio کلیک کنید.
برای کمک به بهبود Android Studio، آمار استفاده را فعال کنید
از آنجایی که این نسخه پیش‌نمایش برنامه‌نویس اندروید استودیو است، بسیاری از این ویژگی‌ها هنوز در دست توسعه هستند. فعال کردن آمار استفاده و ارسال بازخورد برای کمک به ما در بهبود این ابزارها را در نظر بگیرید.
برای فعال کردن آمار استفاده:
روی تنظیمات > ظاهر و رفتار > تنظیمات سیستم > اشتراک گذاری داده کلیک کنید.
ارسال آمار استفاده به گوگل را انتخاب کنید.
محتوا و نمونه کدها در این صفحه مشمول پروانههای توصیفشده در پروانه محتوا هستند. جاوا و OpenJDK علامتهای تجاری یا علامتهای تجاری ثبتشده Oracle و/یا وابستههای آن هستند.
تاریخ آخرین بهروزرسانی 2025-08-01 بهوقت ساعت هماهنگ جهانی.
[[["درک آسان","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-08-01 بهوقت ساعت هماهنگ جهانی."],[],[],null,["# Set up your development environment\n\nTo get started developing for Android XR, use the latest Canary build of\n[Android Studio](/studio/preview), which includes new tools and updates optimized for Android\nXR.\n| **Note:** Ensure you are using the latest Canary build of Android Studio. Other versions might not include Android XR tools.\n\nNew features included in this version of Android Studio are:\n\n- Android XR Emulator\n- Addition of XR support in the Layout Inspector\n- XR Project template\n\nSystem Requirements for Android XR Emulator\n-------------------------------------------\n\n**For macOS:**\n\n- **OS**: macOS 13.3 or later.\n- **CPU/GPU**: Apple Silicon (M1 chip or newer)\n- **RAM/VRAM**: 16 GB or higher\n\n**For Windows:**\n\n- **OS**: Windows 11 or later.\n- **CPU**: Intel 9th generation or later, or AMD Ryzen 1000-series or later.\n- **RAM**: 16 GB or higher\n- **GPU**: NVIDIA GeForce 10 series or later, or AMD Radeon RX 5000 series or later.\n- **VRAM**: 8 GB or higher\n- **BIOS Settings**: VMX CPU extensions must be enabled in your computer's BIOS\n\n| **Note:** You can check if the VMX CPU extensions are already enabled by attempting to run the 2D Android Emulator. If it runs successfully, no BIOS changes are needed.\n\nInstall and configure Android Studio for XR development\n-------------------------------------------------------\n\nComplete the following steps to download Android Studio and set up your\ndevelopment environment:\n\n1. Make sure to close any versions of Android Studio you already have\n installed.\n\n2. Download the latest Canary build of [Android Studio](/studio/preview), extract it into\n your preferred location, and launch the application.\n\n3. Follow the installation instructions in the wizard.\n\n4. In the **Welcome to Android Studio** dialog, click **More Actions** , and\n select **SDK Manager**.\n\n5. In the **Android SDK** page, click the **SDK Tools** tab and select the\n following tools to install:\n\n - Android SDK Build-Tools\n - Android Emulator\n - Android SDK Platform-Tools\n - Layout Inspector for API 31 - 36\n\n | **Note:** If you had a previous version of Android Studio installed, you may need to recheck these boxes, and click **Apply** to download the latest updates.\n6. Under the **SDK Platforms** tab, do the following:\n\n 1. Select the **Show Package Details** checkbox to see all the options.\n 2. Select the **Google Play XR ARM** system image (macOS) or **Google Play\n XR Intel x86_64** (Windows).\n\n 1. Click **Apply** to make the updates, and then click **OK**.\n 2. Allow all the installation steps to complete, then click **Finish**.\n\nCreate an Android XR project\n----------------------------\n\nFollow these steps to create an Android XR project in Android Studio or extend\nan existing project to XR.\n\n1. In the **Welcome to Android Studio** window, do one of the following:\n\n 1. If you're creating a new XR app, click **New Project** and go to the next step.\n 2. If you're spatializing an existing app, click **Open** to select your project, then skip to the next step Create a new Android Virtual Device for the Android Emulator. (For help with spatializing your existing app for Android XR, read [Bring your Android app into 3D with XR](/develop/xr/jetpack-xr-sdk/add-xr-to-existing))\n\n2. In the **XR** category, select the **Basic Headset Activity** template and\n click **Next**.\n\n3. On the next screen you can choose a name for your project. You can leave the\n default settings in place. Then click **Finish**.\n\n4. Explore the code provided in the template. Check out our [development\n guide](/develop/xr/jetpack-xr-sdk/develop-ui) and [reference documentation](/jetpack/androidx/releases/xr-compose).\n\nCreate a new Android Virtual Device for the Android Emulator\n------------------------------------------------------------\n\nThe Android XR Emulator is a specialized version of the Android emulator\ndesigned for XR app development. It lets you test and debug your Extended\nReality (XR) applications within the familiar Android Studio environment.\n| **Caution:** In rare cases, using the emulator can result in system freezes or crashes on some Windows configurations. Please ensure all data is saved before running the emulator. As a workaround, [enable WHPX](/studio/run/emulator-acceleration#vm-windows-whpx). See [release notes](/studio/preview/features) for more known issues.\n\nTo use the Android XR Emulator, you'll have to create a new virtual device.\nFollow these steps to do so:\n\n1. In Android Studio, click **Tools \\\u003e AVD Manager**, and follow the\n instructions to create a new Android Virtual Device (AVD).\n\n2. In the **Add Device** window, under **Form Factor** , select the **XR**\n option, then select **XR Device** in the **Name** list. Click **Next**.\n\n3. In the next tab (**Configure Virtual Device** ), under **System Image**,\n select the most recent Android XR system image that is compatible with your\n system.\n\n4. Click **Finish**.\n\n5. To start the emulator, click the **Run** button in Device Manager.\n\n The emulator opens in a separate window.\n\n6. To launch your app in the emulator, click the **Run** icon in Android\n Studio.\n\nFor details on using the emulator and other new XR tools, read [Android\nStudio Tools for XR](/develop/xr/jetpack-xr-sdk/studio-tools).\n\nEnable Usage Statistics to help improve Android Studio\n------------------------------------------------------\n\nBecause this is a developer preview version of Android Studio, many of these\nfeatures are still under development. Consider enabling usage statistics and\nsending feedback to help us improve these tools.\n\nTo enable Usage Statistics:\n\n1. Click **Settings \\\u003e Appearance \\& Behavior \\\u003e System Settings \\\u003e Data Sharing**.\n2. Select **Send usage statistics to google**."]]
