«میاناهای برنامه‌سازی کاربردی خانه» از OAuth 2.0 برای اعطای دسترسی به دستگاه‌های موجود در ساختار استفاده می‌کند. OAuth به کاربر اجازه می‌دهد بدون نیاز به نمایش اطلاعات اعتباری ورود به سیستم خود، به برنامه یا سرویسی اجازه دهد.
اگر ازقبل کارخواه OAuth تأییدشده‌ای دارید (برای مثال، از برنامه‌ای که قبلاً منتشر شده است)، می‌توانید از آن کارخواه برای آزمایش «میاناهای برنامه‌سازی کاربردی خانه» بدون راه‌اندازی کارخواه جدید استفاده کنید. برای کسب اطلاعات بیشتر، به اگر مشتری OAuth موجود دارید مراجعه کنید.
امضای برنامه
ابتدا با اجرای برنامه در Android Studio، گواهینامه اشکال‌زدایی تولید کنید. وقتی برنامه‌ای را در Android Studio اجرا یا اشکال‌زدایی می‌کنید، به‌طور خودکار گواهینامه اشکال‌زدایی‌ای تولید می‌کند که برای توسعه و اشکال‌زدایی درنظر گرفته شده است. برای توضیح کامل، استودیو Android: امضای ساخت اشکال‌زدایی را ببینید.
پس‌از اجرای برنامه:
دستگاه همراهتان را به ماشین محلی‌تان متصل کنید. Android Studio دستگاه‌های متصل شما را براساس شماره مدل فهرست می‌کند. دستگاهتان را از فهرست انتخاب کنید، سپس روی اجرای پروژه کلیک کنید. این کار «برنامه نمونه» را در دستگاه همراهتان می‌سازد و نصب می‌کند.
برای دستورالعمل‌های دقیق‌تر، به اجرای برنامه‌ها در دستگاه سخت‌افزاری در سایت «توسعه‌دهندگان برنامه Android» مراجعه کنید.
برنامه درحال اجرا را متوقف کنید.
اثر انگشت SHA-1 گواهینامه اشکال‌زدایی را با دنبال کردن دستورالعمل‌های شرح داده‌شده در راه‌اندازی OAuth 2.0 / برنامه‌های بومی / Android در سایت «راهنمای کنسول Google Cloud» دریافت کنید.
راه‌اندازی صفحه کسب رضایت OAuth
- در کنسول Google Cloud، به داشبورد انتخابگر پروژه بروید و پروژه‌ای را که می‌خواهید برای ایجاد اطلاعات اعتباری OAuth استفاده کنید انتخاب کنید.
- به صفحه واسط‌های برنامه‌سازی کاربردی و سرویس‌ها بروید و در منو پیمایش روی اطلاعات اعتباری کلیک کنید.
اگر هنوز صفحه رضایت را برای این پروژه Google Cloud پیکربندی نکرده‌اید، دکمه پیکربندی صفحه رضایت نشان داده می‌شود. در این صورت، صفحه موافقت خود را بااستفاده از روش زیر پیکربندی کنید. درغیراین‌صورت، به بخش بعدی بروید.
- روی پیکربندی صفحه موافقت کلیک کنید. صفحه صفحه کسب رضایت OAuth نمایش داده می‌شود.
- بسته به مورد استفاده‌تان، داخلی یا خارجی را انتخاب کنید، و سپس روی ایجاد کردن کلیک کنید. قاب صفحه کسب رضایت OAuth نمایش داده می‌شود.
- اطلاعات را در صفحه اطلاعات برنامه طبق دستورالعمل‌های روی صفحه وارد کنید و سپس روی ذخیره و ادامه کلیک کنید. قاب محدوده‌ها نمایش داده می‌شود.
- نیازی به افزودن هیچ دامنه‌ای ندارید، بنابراین روی ذخیره و ادامه کلیک کنید. قاب کاربران آزمایش نمایش داده می‌شود.
- روی مخاطب و سپس روی دکمه + افزودن کاربران کلیک کنید.
- نشانی ایمیل کاربر آزمایشی‌تان را وارد کنید و روی دکمه ذخیره کلیک کنید.
- روی ذخیره کردن و ادامه دادن کلیک کنید. قاب خلاصه نمایش داده می‌شود.
- اطلاعات صفحه کسب رضایت OAuth را بررسی کنید، و سپس روی بازگشت به داشبورد کلیک کنید.
برای جزئیات کامل، راه‌اندازی صفحه رضایت OAuth در سایت «راهنمای کنسول Google Cloud» را ببینید.
برنامه را ثبت کنید و اطلاعات اعتباری ایجاد کنید
برای ثبت برنامه برای OAuth 2.0 و ایجاد اعتبارنامه‌های OAuth، دستورالعمل‌های ارائه‌شده در راه‌اندازی OAuth 2.0 را دنبال کنید. باید نوع برنامه را که برنامه بومی/Android است مشخص کنید.
اثر انگشت SHA-1 را که از امضای برنامه دریافت کرده‌اید به کارخواه OAuth که در «کنسول Google Cloud» راه‌اندازی کرده‌اید اضافه کنید. برای این کار، دستورالعمل‌های راه‌اندازی OAuth 2.0 / برنامه‌های بومی در سایت «راهنمای کنسول Google Cloud» را دنبال کنید.
با متصل بودن دستگاه همراهتان به ماشین محلی، دستگاهتان را از فهرست انتخاب کنید، سپس دوباره روی اجرای پروژه کلیک کنید تا اجرا شود. برای دستورالعمل‌های دقیق‌تر، اجرای برنامه‌ها در دستگاه سخت‌افزاری در سایت «توسعه‌دهندگان Android» را ببینید.
اگر کارخواه OAuth موجودی دارید
اگر ازقبل کارخواه OAuth درستی‌سنجی‌شده‌ای برای برنامه منتشرشده دارید، می‌توانید از کارخواه OAuth موجودتان برای آزمایش «میاناهای برنامه‌سازی کاربردی خانه» استفاده کنید.
برای آزمایش و استفاده از Home APIs، ثبت‌نام Google Home Developer Console الزامی نیست. بااین‌حال، حتی اگر کارخواه OAuth درستی‌سنجی‌شده‌ای از یک یکپارچه‌سازی دیگر داشته باشید، همچنان برای انتشار برنامه‌تان به ثبت Developer Console تأییدشده نیاز خواهید داشت.
ملاحظات زیر اعمال می‌شود:
هنگام استفاده از کارخواه OAuth موجود، محدودیت ۱۰۰ کاربر وجود دارد. برای کسب اطلاعات درباره افزودن کاربران آزمایش، به صفحه کسب رضایت OAuth را راه‌اندازی کنید. صرف‌نظر از درستی‌سنجی OAuth، محدودیت اعمال‌شده توسط Home APIs برای تعداد کاربرانی که می‌توانند به برنامه شما اجازه دهند ۱۰۰ نفر است. این محدودیت پس‌از تکمیل ثبت‌نام Developer Console برداشته می‌شود.
Developer Console ثبت باید وقتی آماده‌اید اعطای مجوز نوع دستگاه را ازطریق OAuth محدود کنید برای تأیید ارسال شود تا برای به‌روزرسانی برنامه‌تان با «میاناهای برنامه‌سازی کاربردی Home» آماده شوید.
برای Google Cloud برنامه‌ای که درستی‌سنجی OAuth آن‌ها هنوز معلقه است، کاربران تا زمانی که درستی‌سنجی تکمیل نشود نمی‌توانند جریان OAuth را تکمیل کنند. تلاش برای اعطای اجازه‌ها با خطای زیر ناموفق خواهد بود:
Access blocked: <Project Name> has not completed the Google verification process.