برنامه نمونه Home APIs Android

«برنامه نمونه» قابلیت‌های پایه «میاناهای برنامه‌سازی کاربردی Google Home» را برای Android نمایش می‌دهد.

پیش‌نیازها

برای ساختن، نصب کردن، و آزمایش برنامه، باید چند پیش‌نیاز را برآورده کنید:

• ‫Android Studio، نسخه 2024.2.1 («کفشدوزک») یا جدیدتر. توجه داشته باشید که نسخه‌های قدیمی‌تر از این نسخه ممکن است با «کیت توسعه نرم‌افزار» Home APIs به‌درستی کار نکند.

  بارگیری «استودیو Android»

• اشکال‌زدای Android (adb).

  نصب adb.

  این کار را می‌توان با مدیر کیت توسعه نرم‌افزار انجام داد.

و برای آزمایش «میاناهای برنامه‌سازی کاربردی خانه هوشمند»، به موارد زیر نیاز دارید:

• دستگاه Android با Android 10 یا نسخه‌های جدیدتر که با «حساب Google» راه‌اندازی شده باشد و قصد داشته باشید از آن برای توسعه استفاده کنید. مطمئن شوید نسخه به‌روزی از Android Studio نصب شده باشد و با این حساب توسعه‌دهنده به سیستم آن وارد شده باشید.
• شبکه Wi-Fi.
• برای دسترسی و کنترل Matter دستگاه، به مرکز کنترل Google که از «میاناهای برنامه‌سازی کاربردی خانه» پشتیبانی می‌کند نیز نیاز دارید. برای جزئیات، اتصال‌پذیری در Android را ببینید.

• حداقل یک دستگاه پشتیبانی‌شده در خانه. اگر این دستگاه (یا هر دستگاه دیگری که می‌خواهید آزمایش کنید) از Thread استفاده می‌کند، مرکز کنترل باید Thread Border Router (TBR) نیز باشد. برنامه نمونه Android از انواع و ویژگی‌های دستگاه زیر پشتیبانی می‌کند:

  • چراغ دمای رنگ (روشن و خاموش، روشنایی)
  • حسگر تماس (وضعیت بولی)
  • چراغ کم‌نورشدنی (روشن و خاموش، روشنایی)
  • قفل در
  • چراغ رنگی گسترده (روشن و خاموش، روشنایی)
  • کلید عمومی
  • رهیاب مرزی Google
  • دوربین Google
  • زنگ در Google
  • حسگر حضور (تشخیص حضور)
  • روشن/خاموش کردن چراغ (روشن و خاموش، روشنایی)
  • کلید روشن/خاموش چراغ
  • واحد افزایه روشن/خاموش (روشن و خاموش)
  • حسگر روشن/خاموش

بارگیری کد منبع

کد منبع برای «برنامه نمونه» در GitHub دردسترس است.

به جایی که می‌خواهید پروژه را ذخیره کنید بروید، سپس آن را همانندسازی کنید:

git clone https://github.com/google-home/google-home-api-sample-app-android.git

راه‌اندازی کیت توسعه نرم‌افزار

«میاناهای برنامه‌سازی کاربردی خانه» برای Android در این نسخه بتای باز هنوز بخشی از کتابخانه‌های استاندارد ارائه‌شده توسط Google برای توسعه نیستند. برای توسعه برنامه‌های Android با «میاناهای برنامه‌سازی کاربردی خانه»، باید کتابخانه‌ها را به‌صورت محلی بارگیری و میزبانی کنید.

برای بارگیری «کیت توسعه نرم‌افزار Android میاناهای برنامه‌سازی کاربردی خانه»، ابتدا باید به سیستم «توسعه‌دهندگان خانه هوشمند Google» وارد شوید.

اکنون به سیستم وارد شوید!

ساختن برنامه

1. Android Studio را باز کنید، سپس پوشه پروژه google-home-api-sample-app-android را که در دستگاه محلی شما شبیه‌سازی شده است باز کنید.

2. درطول راه‌اندازی اولیه، ممکن است Android Studio تا ۱۰ دقیقه طول بکشد تا همه وابستگی‌های پروژه را بارگیری کند و ساخت Gradle را تکمیل کند.

3. رایانه خود را ازطریق کابل USB به تلفن Android فیزیکی وصل کنید و «پل اشکال‌زدایی Android» را در گزینه‌های توسعه‌دهنده فعال کنید. مطمئن شوید Android Studio می‌تواند ازطریق ADB به تلفن Android متصل شود.

4. نام بسته «برنامه نمونه» را به نام جدیدی که قبلاً ثبت نشده است تغییر دهید، مثلاً نامی که براساس نام سازمانتان باشد:

   1. پروژه را باز کنید.
   2. ازهم بازکردن سلسله مراتب منبع.
   3. بخشی از بسته را که می‌خواهید تغییر دهید انتخاب کنید - به عبارت دیگر، com.example.
   4. روی بسته کلیک راست کنید و بازسازی > تغییر نام… را انتخاب کنید
   5. نام جدید را وارد کنید و روی Refactor (بازسازی) کلیک کنید.
   6. فایل build.gradle.kts را ویرایش کنید و android namespace و applicationId را به نام بسته جدید تغییر دهید.

5. پس‌از بارگیری همه کتابخانه‌های موردنیاز و تکمیل همگام‌سازی Gradle، روی دکمه اجرا کلیک کنید تا برنامه ساخته و اجرا شود. وقتی برنامه با موفقیت در تلفنتان اجرا شد، صفحه اصلی «برنامه نمونه» را خواهید دید.

ایجاد گواهینامه امضا

وقتی برنامه‌ای را در Android Studio اجرا یا اشکال‌زدایی می‌کنید، به‌طور خودکار گواهینامه اشکال‌زدایی‌ای تولید می‌کند که برای توسعه و اشکال‌زدایی درنظر گرفته شده است. برای توضیح کامل، به Android Studio: Sign your debug build مراجعه کنید.

1. با اجرای برنامه در Android Studio، گواهینامه امضای برنامه اشکال‌زدایی تولید کنید. وقتی برنامه‌ای را در Android Studio اجرا یا اشکال‌زدایی می‌کنید، Android Studio به‌طور خودکار گواهینامه امضای برنامه‌ای را که برای توسعه و اشکال‌زدایی درنظر گرفته شده است تولید می‌کند. برای توضیح کامل، به Android Studio: Sign your debug build (امضای ساخت اشکال‌زدایی) مراجعه کنید.

   دستگاه همراهتان را به ماشین محلی‌تان متصل کنید. ‫Android Studio دستگاه‌های متصل را براساس مدل شماره فهرست می‌کند. دستگاهتان را از فهرست انتخاب کنید، سپس روی اجرای پروژه کلیک کنید. این برنامه نمونه را در دستگاه همراهتان می‌سازد و نصب می‌کند.

   برای دستورالعمل‌های دقیق‌تر، به اجرای برنامه‌ها در دستگاه سخت‌افزاری در سایت «توسعه‌دهندگان برنامه Android» مراجعه کنید.

   اکنون برنامه درحال اجرا را متوقف کنید.

2. اثر انگشت SHA-1 گواهینامه اشکال‌زدایی خود را با دنبال کردن دستورالعمل‌های تفصیلی در مدیریت کارخواه‌های OAuth / انواع برنامه / برنامه‌های بومی / Android در سایت «راهنمای Google Cloud Console» دریافت کنید.

راه‌اندازی موافقت OAuth

1. در کنسول Google Cloud، به داشبورد انتخابگر پروژه بروید و پروژه‌ای را که می‌خواهید برای ایجاد اطلاعات اعتباری OAuth استفاده کنید انتخاب کنید.
2. به صفحه واسط‌های برنامه‌سازی کاربردی و سرویس‌ها بروید و در منو پیمایش روی اطلاعات اعتباری کلیک کنید.

3. اگر هنوز صفحه رضایت را برای این پروژه Google Cloud پیکربندی نکرده‌اید، دکمه پیکربندی صفحه رضایت نشان داده می‌شود. در این صورت، صفحه موافقت خود را بااستفاده از روش زیر پیکربندی کنید. درغیراین‌صورت، به بخش بعدی بروید.

   1. روی پیکربندی صفحه موافقت کلیک کنید. صفحه صفحه کسب رضایت OAuth نمایش داده می‌شود.
   2. بسته به مورد استفاده‌تان، داخلی یا خارجی را انتخاب کنید، و سپس روی ایجاد کردن کلیک کنید. قاب صفحه کسب رضایت OAuth نمایش داده می‌شود.
   3. اطلاعات را در صفحه اطلاعات برنامه طبق دستورالعمل‌های روی صفحه وارد کنید و سپس روی ذخیره و ادامه کلیک کنید. قاب محدوده‌ها نمایش داده می‌شود.
   4. نیازی به افزودن هیچ دامنه‌ای ندارید، بنابراین روی ذخیره و ادامه کلیک کنید. قاب کاربران آزمایش نمایش داده می‌شود.
   5. روی مخاطب و سپس روی دکمه + افزودن کاربران کلیک کنید.
   6. نشانی ایمیل کاربر آزمایشی‌تان را وارد کنید و روی دکمه ذخیره کلیک کنید.
   7. روی ذخیره کردن و ادامه دادن کلیک کنید. قاب خلاصه نمایش داده می‌شود.
   8. اطلاعات صفحه کسب رضایت OAuth را بررسی کنید، و سپس روی بازگشت به داشبورد کلیک کنید.

برای جزئیات کامل، راه‌اندازی صفحه رضایت OAuth در سایت «راهنمای کنسول Google Cloud» را ببینید. حتماً قبل‌از ادامه دادن، حداقل یک کاربر آزمایشگر اضافه کنید.

راه‌اندازی اعتبارنامه‌های OAuth

1. «برنامه نمونه» را برای OAuth 2.0 ثبت کنید و اعتبارنامه‌های OAuth را با دنبال کردن دستورالعمل‌های ارائه‌شده در راه‌اندازی OAuth 2.0 ایجاد کنید.
   1. نوع برنامه را که برنامه بومی/Android است مشخص کنید.
   2. با دنبال کردن دستورالعمل‌های راه‌اندازی OAuth 2.0 / برنامه‌های بومی / Android در سایت «راهنمای Google Cloud Console»، اثر انگشت SHA-1 را به کارخواه OAuth اضافه کنید. باید کلید SHA-1 را از کلید پیش‌فرض Android Studio درطول فرایند توسعه تولید کنید.

اجرای برنامه

1. با متصل بودن دستگاه همراه به ماشین محلی، دوباره روی اجرای پروژه کلیک کنید تا «برنامه نمونه» در دستگاه همراهتان اجرا شود.

پس‌از نصب، برنامه در دستگاه همراهتان به‌عنوان برنامه نمونه Home API دردسترس است.