افزودن برنامه وب پیشرو خود به Google Play

1. خوش آمدید

در این آزمایشگاه، یک برنامه وب پیشرو موجود را که مستقر کرده اید، می گیرید و آن را در یک برنامه برای توزیع در فروشگاه Play Google قرار می دهید.

چیزی که یاد خواهید گرفت

  • نحوه استفاده از Bubblewrap برای بسته بندی برنامه وب پیشرفته خود برای فروشگاه Play Google
  • Signing Key چیست و چگونه از آن استفاده کنیم
  • نحوه ایجاد یک برنامه جدید در کنسول برنامه نویس Google Play و تنظیم نسخه آزمایشی برای آزمایش برنامه خود قبل از انتشار
  • پیوندهای دارایی دیجیتال چیست و چگونه آنها را به برنامه وب خود اضافه کنید

آنچه شما باید بدانید

آنچه شما نیاز دارید

  • یک برنامه وب پیشرفته که به صورت زنده در اینترنت منتشر می شود و می توانید تغییراتی در آن ایجاد کنید
  • رابط خط فرمان Bubblewrap نصب شده و آماده استفاده است
  • یک حساب توسعه دهنده Google Play
  • اگر قبلاً برنامه‌هایی را در Google Play راه‌اندازی کرده‌اید، کلید امضای موجود شما
  • دستگاه Android یا Chrome OS برای آزمایش

آنچه پوشش داده نخواهد شد

  • PWA خود را فقط به دستگاه‌های Android یا فقط Chrome OS محدود کنید
  • استقرار یک PWA برای سیستم عامل Chrome و یک برنامه Android برای دستگاه های تلفن همراه تحت همان برنامه .
  • نحوه پیروی از خط‌مشی پرداخت Google Play در PWA .

2. PWA خود را با حباب بسته بندی کنید

Bubblewrap ابزاری برای قرار دادن برنامه وب پیشرو خود در یک بسته نرم افزاری Android به آسانی اجرای چند دستور CLI است. این کار را با ایجاد یک پروژه Android انجام می دهد که PWA شما را به عنوان یک فعالیت وب مورد اعتماد راه اندازی می کند.

برای شروع، یک دایرکتوری برای پروژه خود ایجاد کنید و به آن بروید:

$ mkdir my-pwa && cd my-pwa

سپس، ابزار خط فرمان Bubblewrap را اجرا کنید تا پیکربندی و پروژه Android را برای Android App Bundle که در Play آپلود می کنید، ایجاد کنید:

$ bubblewrap init --manifest=https://my-pwa.com/manifest.json

در اینجا، Bubblewrap با محل فایل Manifest برنامه وب PWA مقدار دهی اولیه می شود. این یک پیکربندی پیش‌فرض از Web App Manifest ایجاد می‌کند و یک جادوگر درون کنسولی راه‌اندازی می‌کند که به شما امکان می‌دهد پیکربندی پیش‌فرض را تغییر دهید. برای تغییر هر یک از مقادیر تولید شده توسط ابزار، جادوگر را دنبال کنید.

جادوگر CLI Bubblewrap که یک مقدار دهی اولیه از airhorner را نشان می دهد که دامنه با example,.com لغو شده و URL های شروع لغو شده است.

کلید امضا

فروشگاه Play Google به بسته‌های برنامه نیاز دارد که هنگام آپلود با گواهی امضا شوند که اغلب به عنوان کلید امضا نامیده می‌شود. این یک گواهی امضا شده است و با گواهی استفاده شده برای ارائه برنامه شما از طریق HTTPS متفاوت است.

Bubblewrap هنگام ایجاد برنامه، مسیر کلید را می خواهد. اگر از فهرست موجود Play Store برای برنامه خود استفاده می کنید، باید مسیر را به همان کلید مورد استفاده در آن فهرست اضافه کنید.

جادوگر CLI Bubblewrap که مکان و نام کلید امضای موجود کاربر را می‌پرسد.

اگر کلید امضای موجود ندارید و در حال ایجاد یک فهرست جدید در فروشگاه Play هستید، می‌توانید از مقدار پیش‌فرض ارائه‌شده توسط Bubblewrap استفاده کنید تا کلید جدیدی برای شما ایجاد کند:

جادوگر CLI Bubblewrap از کاربر می‌پرسد که آیا می‌خواهد کلید امضای جدیدی ایجاد کند.

خروجی حباب بند

پس از مقداردهی اولیه پروژه Bubblewrap و تکمیل ویزارد، موارد زیر ایجاد خواهند شد:

  • twa-manifest.json - پیکربندی پروژه، منعکس کننده مقادیر انتخاب شده در جادوگر Bubblewrap. شما می خواهید این فایل را با سیستم کنترل نسخه خود ردیابی کنید، زیرا در صورت نیاز می توان از آن برای بازسازی کل پروژه Bubblewrap استفاده کرد.
  • فایل‌های پروژه اندروید - فایل‌های باقی‌مانده در فهرست، پروژه اندروید تولید شده است. این پروژه منبعی است که برای دستور ساخت Bubblewrap استفاده می شود. شما همچنین می توانید به صورت اختیاری این فایل ها را با سیستم کنترل نسخه خود ردیابی کنید.
  • (اختیاری) کلید امضا - اگر انتخاب کنید که Bubblewrap کلید امضا را برای شما ایجاد کند، کلید به محل توضیح داده شده در جادوگر خروجی خواهد شد. اطمینان حاصل کنید که کلید در مکانی امن نگهداری می شود و تعداد افرادی که به آن دسترسی دارند محدود کنید. این همان چیزی است که برای اثبات اینکه برنامه‌های موجود در Play Store از شما می‌آیند استفاده می‌شود.

با استفاده از این فایل‌ها، ما اکنون هر آنچه را که برای ساختن یک بسته نرم افزاری Android نیاز داریم در اختیار داریم.

بسته نرم افزاری اندروید خود را بسازید

از داخل همان دایرکتوری که دستور اولیه سازی Bubblewrap را اجرا کردید، موارد زیر را اجرا کنید (شما به رمزهای عبور برای کلید امضای خود نیاز دارید):

$ bubblewrap build

خروجی Bubblewrap CLI برای ساخت یک پروژه، درخواست رمز عبور برای کلید امضا و نمایش تولید نسخه های مختلف برنامه اندروید.

دستور build دو فایل مهم تولید می کند:

  • app-release-bundle.aab - بسته برنامه Android PWA شما. این فایلی است که در فروشگاه Google Play آپلود خواهید کرد.
  • app-release-signed.apk - یک قالب بسته بندی اندروید که می تواند برای نصب برنامه به طور مستقیم روی دستگاه توسعه با استفاده از دستور bubblewrap install استفاده شود.

3. آن را امتحان کنید - Bubblewrap

حالا نوبت شماست! با استفاده از آنچه در مرحله قبل یاد گرفتید، سعی کنید موارد زیر را انجام دهید:

  1. یک دایرکتوری برای نگهداری پروژه اندروید تولید شده خود ایجاد کنید.
  2. آن دایرکتوری را با Bubblewrap و مانیفست برنامه وب PWA خود راه اندازی کنید.
  3. کلید امضای جدید ایجاد کنید، یا در صورت داشتن کلیدهای موجود، دوباره از آنها استفاده کنید.
  4. Android App Bundle خود را از پروژه Android ایجاد شده بسازید.

4. افزودن برنامه خود به فروشگاه Play Google

اکنون که یک Android App Bundle برای PWA خود دارید، وقت آن است که آن را در فروشگاه Play Google آپلود کنید! هنگامی که حساب توسعه دهنده خود را ثبت کردید، می توانید برای ورود و شروع به کنسول Play بروید.

یک برنامه ایجاد کنید

پس از ورود به سیستم، صفحه ای را مشاهده خواهید کرد که همه برنامه های شما را نشان می دهد. در نزدیکی بالا، دکمه ای وجود دارد، Create app که با کلیک روی آن، صفحه زیر را نشان می دهد تا شما را در ایجاد لیست جدید برنامه اندروید راهنمایی کند.

صفحه ای که فرم ایجاد برنامه کنسول Play را نشان می دهد.

تعدادی فیلد در اینجا برای پر کردن وجود دارد، از جمله نام برنامه، زبان پیش‌فرض، برنامه یا بازی، رایگان یا پولی بودن و تعدادی اعلامیه. بدون موافقت با اعلامیه‌ها نمی‌توانید برنامه ایجاد کنید، بنابراین مهم است که آنها را بخوانید و قبل از موافقت با آنها درک کنید.

هنگامی که تمام اطلاعات را پر کردید و روی دکمه ایجاد برنامه در پایین فرم کلیک کردید، به داشبورد برنامه جدید خود منتقل خواهید شد. در داشبورد، چک‌لیست‌هایی از وظایفی را می‌بینید که برای راه‌اندازی، شروع آزمایش و انتشار برنامه‌تان باید تکمیل کنید.

تست داخلی را تنظیم کنید

آزمایش داخلی روشی عالی برای انتشار سریع برنامه‌تان بدون بررسی به گروهی از آزمایش‌کنندگان مورد اعتمادی است که انتخاب می‌کنید. وظایف را در چک لیست شروع آزمایش اکنون مشاهده کنید و انتخاب آزمایش کنندگان را انتخاب کنید.

اکنون چک لیست آزمایش را شروع کنید

با کلیک بر روی آن کار به صفحه تست داخلی می روید. اینجاست که تنظیمات آزمایشی برنامه خود را مدیریت خواهید کرد. می‌توانید با باز کردن بخش Testing در زیر منوی انتشار در نوار کناری، دوباره به آن بروید. اولین کاری که باید در اینجا انجام دهید این است که یک لیست ایمیل از آزمایش کنندگان برای آزمایش برنامه خود ایجاد کنید. برای انجام این کار، روی پیوند ایجاد لیست ایمیل در بخش آزمایش کنندگان صفحه کلیک کنید. با این کار یک پنجره بازشو برای ایجاد لیست ایمیل شما باز می شود.

پنجره بازشو فرم ایجاد لیست ایمیل را نشان می دهد که شامل نام لیست، آدرس های ایمیل، پیوندی برای آپلود یک فایل CSV از آدرس های ایمیل، و ناحیه ای برای نشان دادن آدرس های ایمیل آپلود شده است.

در این پنجره بازشو، لیست ایمیل خود را نامگذاری می کنید و می توانید به صورت دستی آدرس های ایمیل را وارد کنید یا یک CSV از آدرس های ایمیل را برای استفاده آپلود کنید. پس از اتمام، دکمه ذخیره تغییرات را فشار دهید. می‌توانید به فهرست‌های ایمیلی که قبلاً ایجاد کرده‌اید بازگردید تا در صورت نیاز آدرس‌های ایمیل را اضافه یا حذف کنید. پس از افزودن آزمایش‌کنندگان، نوبت به ایجاد نسخه آزمایشی می‌رسد. روی دکمه ایجاد نسخه جدید در بالای صفحه کلیک کنید.

صفحه آزمایش داخلی با فلشی که به دکمه ایجاد نسخه جدید اشاره دارد.

یک نسخه آزمایشی ایجاد کنید

پس از کلیک بر روی دکمه ایجاد نسخه جدید ، از طریق تعدادی بخش از شما خواسته می شود. اولین مورد، یکپارچگی برنامه ، جایی است که شما نحوه مدیریت کلید امضای برنامه خود را انتخاب می کنید. گزینه پیش‌فرض این است که به Google اجازه دهید کلید امضای شما را مدیریت کند و گزینه پیشنهادی است زیرا هم ایمن است و هم برنامه شما را در صورت گم کردن کلید آپلود قابل بازیابی نگه می‌دارد.

Play App Signing

فلوچارتی که از چپ به راست، یک برنامه‌نویس و کلید آپلود او را نشان می‌دهد که سپس برنامه خود را امضا کرده و به Google ارسال می‌کند. سپس گوگل یک کلید امضای برنامه دارد و برنامه را با آن کلید امضا می کند، سپس آن را به کاربر تحویل می دهد

آپلود و نهایی سازی برنامه

پس از انتخاب نحوه مدیریت کلید امضا، از شما خواسته می‌شود که بسته برنامه خود را در نسخه خود آپلود کنید. برای انجام این کار، فایل app-release-bundle.aab را که Bubblewrap ایجاد کرده است، بکشید و در فرم رها کنید. برای نهایی کردن نسخه، جزئیات باقیمانده نسخه را پر کنید و روی ذخیره ، سپس نسخه بررسی ، و در نهایت روی دکمه‌های Start rollout to testing داخلی کلیک کنید تا انتشار خود شروع شود. این برنامه شما را در دسترس آزمایش کنندگان داخلی شما قرار می دهد! در برگه آزمایش‌کنندگان صفحه آزمایش داخلی ، می‌توانید پیوندی را برای اشتراک‌گذاری با آزمایش‌کنندگان خود کپی کنید تا بتوانند به برنامه شما دسترسی داشته باشند.

صفحه آزمایش داخلی، با فلشی که به پیوند پیوند کپی برای اشتراک‌گذاری پیوند آزمایشی با آزمایش‌کنندگان اشاره دارد.

5. آن را امتحان کنید - یک برنامه ایجاد کنید

حالا نوبت شماست! با استفاده از آنچه در مرحله قبل یاد گرفتید، سعی کنید موارد زیر را انجام دهید:

  1. یک برنامه جدید برای PWA خود در Play Console ایجاد کنید.
  2. تست داخلی برنامه را تنظیم کنید و خود را به عنوان آزمایش کننده اضافه کنید.
  3. بسته نرم افزاری خود را آپلود کنید و یک نسخه آزمایشی برای برنامه خود ایجاد کنید.
  4. با استفاده از پیوند تست، برنامه خود را از فروشگاه Play بر روی دستگاه Android یا Chrome OS خود نصب کنید!

6. پیوندهای دارایی دیجیتال

اگر PWA خود را در Play آزمایش کرده اید، ممکن است متوجه شوید که تمام صفحه اجرا نمی شود. دلیلش این است که شما هنوز مالکیت سایت را از طریق فایل پیوندهای دارایی دیجیتال تأیید نکرده اید. در حالی که Bubblewrap قادر است بسته نرم افزاری اندروید شما را پیکربندی و بسازد، باید پیوند را با به روز رسانی برنامه وب خود تکمیل کنید.

اثر انگشت SHA-256 برنامه خود را دریافت کنید

برای پیکربندی پیوندهای دارایی دیجیتال PWA خود، به اثر انگشت SHA-256 برای گواهی استفاده شده برای امضای بسته ای که کاربر در تلفن خود دریافت می کند ، نیاز دارید.

با امضای برنامه Play

اگر هنگام ایجاد نسخه خود، Play App Signing را برای برنامه خود تنظیم کرده باشید (که قبلاً توصیه می شد)، اثر انگشت SHA-256 را می توانید در کنسول Play پیدا کنید. به یاد داشته باشید، این گواهی با گواهی استفاده شده برای آپلود برنامه شما متفاوت است. برای دریافت اثر انگشت، از داخل برنامه خود در Play Console، به Releases->Setup->App Integrity بروید. در آنجا، تعدادی گزینه را در زیر گواهینامه کلید امضای برنامه مشاهده خواهید کرد. مقدار اثر انگشت گواهی SHA-256 را کپی کنید.

صفحه نمایش یکپارچگی برنامه با اثر انگشت گواهی SHA-256 برجسته شده است.

بدون امضای برنامه Play

اگر از Play App Signing انصراف داده باشید، کلید مورد استفاده برای امضای برنامه نهایی همان کلیدی است که برای آپلود برنامه در Play Console استفاده می‌کنید. برای استخراج اثر انگشت می توانید از ابزار کلید جاوا استفاده کنید:

$ keytool -list -v \
    -keystore <keystore-file-path> \
    -alias <key-alias> \
    -keypass <key-password> \
    -storepass <store-password> | grep SHA256

$     SHA256: BD:92:64:B0:1A:B9:08:08:FC:FE:7F:94:B2...

برای استفاده از آن، باید مسیر کلید امضای خود و رمزهای عبور مربوطه را بدانید. مقادیر هگزادسیمال کلید SHA256 را کپی کنید.

Bubblewrap می تواند اثر انگشت امضایی را که بازیابی کرده اید مدیریت کند و فایل پیوند دارایی دیجیتال صحیح را برای شما ایجاد کند. برای افزودن اثر انگشت با Bubblewrap، دستور زیر را از همان دایرکتوری ایجاد شده در حین حباب پیچیدن PWA اجرا کنید و اثر انگشت کپی شده از مرحله قبل را جایگزین <fingerprint> کنید.

$ bubblewrap fingerprint add <fingerprint>

این دستور اثر انگشت را به لیست اثر انگشت برنامه اضافه می کند و یک فایل assetlinks.json ایجاد می کند. این فایل را در دایرکتوری .well-known در همان مبدا PWA خود آپلود کنید.

7. آن را امتحان کنید - پیوندهای دارایی دیجیتال

حالا نوبت شماست! با استفاده از آنچه در مرحله قبل یاد گرفتید، سعی کنید موارد زیر را انجام دهید:

  1. اثر انگشت SHA-256 برنامه خود را پیدا کنید.
  2. یک فایل پیوند دارایی دیجیتال برای برنامه خود ایجاد کنید.
  3. فایل پیوندهای دارایی دیجیتال خود را در PWA خود آپلود کنید.
  4. بررسی کنید که فایل پیوندهای دارایی دیجیتال شما با استفاده از API و برنامه آزمایشی شما به درستی تنظیم شده باشد.

8. دانش خود را بیازمایید

قبل از اتمام، دانش خود را محک بزنید و با پاسخ دادن به سوالات زیر ببینید چه آموخته اید. به جواب ها نگاه نکنید!

سالی پس از تولید پروژه اندروید خود با Bubblewrap، فایل ______ تولید شده را به سیستم کنترل نسخه خود می‌سپارد تا بتواند هر زمان که نیاز داشت آن را بازسازی کند.

twa-manifest.json کلید امضا app-release-bundle.aab build.gradle

جک به دنبال این است که تیم QA خود برنامه اندروید PWA خود را آزمایش کند. او ______ App Bundle Android خود را به یک مسیر تست داخلی وارد کرد.

آپلودها می سازد و آپلود می کند منتشر شده نشانه ها و بارگذاری ها

برنامه اندروید PWA Oogie Boogie تمام صفحه اجرا نمی شود. برای رفع آن، آنها اثر انگشت گواهی SHA-256 خود را برای ______ خود دریافت می کنند و آن را در فایل پیوندهای دارایی دیجیتال خود واقع در ______ در همان مبدأ PWA خود آپلود می کنند.

کلید آپلود، /.well-known/assetlinks.json کلید آپلود، /assetlinks.json کلید امضاء، /.well-known/assetlinks.json کلید امضاء، /assetlinks.json

9. دانش خود را بیازمایید - پاسخ ها

پاسخ به سوالات تست دانش شما!

  1. سالی پس از تولید پروژه اندروید خود با Bubblewrap، فایل ______ تولید شده را به سیستم کنترل نسخه خود می‌سپارد تا بتواند هر زمان که نیاز داشت آن را بازسازی کند.
  2. جک به دنبال این است که تیم QA خود برنامه اندروید PWA خود را آزمایش کند. او ______ App Bundle Android خود را به یک مسیر تست داخلی وارد کرد.
  3. برنامه اندروید PWA Oogie Boogie تمام صفحه اجرا نمی شود. برای رفع آن، آنها اثر انگشت گواهی SHA-256 خود را برای ______ خود دریافت می کنند و آن را در فایل پیوندهای دارایی دیجیتال خود واقع در ______ در همان مبدأ PWA خود آپلود می کنند.

10. تبریک می گویم!

تبریک می گویم! شما با موفقیت یاد گرفتید که چگونه PWA خود را به فروشگاه Play Google اضافه کنید!

هنگامی که احساس کردید برای انجام این کار آماده هستید، این مراحل بعدی را خودتان امتحان کنید:

کد نویسی مبارک!