خلق و انتشار
از پیش‌نمایش تا انتشار و اتصال مخزن
قبل از عمومی‌کردن پروژه، مسیر اصلی، داده‌ها و فایل‌ها را بررسی کن و نشانی عمومی را مستقل آزمایش کن.
پیش‌نمایش جای بررسی است. انتشار، خروجی را از یک نشانی عمومی در دسترس قرار می‌دهد. اتصال مخزن هم مسیر نگهداری و ادامهٔ کد است. این سه مرحله را جدا و با مقصد روشن پیش ببر.
- مسیر اصلی و موبایل بررسی شده‌اند.
- دادهٔ نمونه و اتصال واقعی روشن‌اند.
- مقصد انتشار یا مخزن مشخص است.
پیش‌نمایش را با یک سناریو امتحان کن
از ورود به صفحه تا انجام کار اصلی جلو برو. دکمه‌ها، لینک‌ها، حالت خالی و فرم ناقص را ببین. مشخص کن کدام داده نمونه است و کدام اتصال فعال شده است. همین مسیر را روی موبایل هم بررسی کن.
برای انتشار، مقصد را روشن کن
نام پروژه و نشانی مورد نظر را پیش از اقدام مشخص کن. اگر مسیر انتشار در پروژه فعال است، وضعیت همان عملیات را دنبال کن. صرف دیده‌شدن صفحه در قاب پیش‌نمایش یا نمایش یک پیام، اثبات دسترسی عمومی نیست.
برنامهٔ موبایل یا دسکتاپ را برای دریافت منتشر کن
در فضای پروژه، «انتشار پروژه» را باز کن و «دانلود برنامه» را انتخاب کن. فایل نصب را از outputs یا releases انتخاب کن؛ فایل باید حداکثر ۱۵ مگابایت باشد. APK و AAB اندروید و نصب‌کننده‌های EXE، MSI، DMG، AppImage، DEB و RPM پشتیبانی می‌شوند. فایل ZIP عمومی یا کلید امضا در این مسیر منتشر نمی‌شود.
نام، معرفی کوتاه و نسخه را وارد کن تا صفحهٔ اختصاصی برنامه در /downloads/ ساخته شود. با انتخاب «در مارکت عمومی ساروی هم نمایش بده»، دیگران هم می‌توانند برنامه یا عاملت را در مارکت پیدا کنند. این گزینه پیش‌فرض خاموش است و اگر پروژه خروجی وب داشته باشد، وب‌سایت هم حفظ می‌شود. برنامه روی دستگاه کاربر اجرا می‌شود؛ میزبانی دانلود جای اتصال بک‌اند یا انتشار در فروشگاه برنامه را نمی‌گیرد. فایل دریافت‌شده، امضا و نصب روی دستگاه واقعی را بررسی کن.
بک‌اند برنامه یا ربات وب‌هوک را منتشر کن
گزینهٔ «بک‌اند / ربات با درخواست HTTP» برای API برنامهٔ موبایل و ربات‌هایی است که با دریافت درخواست کار می‌کنند. از ساروی بخواه مسیرهای Node.js سازگار در api/، ورود و مجوز کاربران و یک مسیر بررسی سلامت واقعی بسازد. داده‌های ماندگار باید در بک‌اند متصل یا فضای دادهٔ سرور نگهداری شوند.
توکن ربات و سایر کلیدها را در «متغیرهای محرمانهٔ بک‌اند» وارد کن. این مقدارها به محیط سرور فرستاده می‌شوند و دوباره نمایش داده نمی‌شوند؛ برای تغییر، همان نام را با مقدار جدید وارد و دوباره منتشر کن. کلید را در کد مرورگر یا فایل نصب قرار نده.
این مسیر اجرای دائمی، ربات polling، اتصال همیشگی یا زمان‌بندی کارها را ارائه نمی‌کند. Cloud Starter نیز محدودیت‌های جداگانهٔ خودش را دارد. بعد از انتشار، یک درخواست واقعی، حالت خطا، مجوزها و اتصال داده را روی نشانی عمومی آزمایش کن.
دامنه و مخزن را جدا تنظیم کن
برای دامنهٔ اختصاصی، رکوردهای نمایش‌داده‌شده در مسیر اتصال را در ارائه‌دهندهٔ دامنه ثبت و وضعیت تأیید و HTTPS را بررسی کن. از رکوردهای حدسی یا مربوط به پروژهٔ دیگر استفاده نکن.
برای GitHub، حساب و مخزن مقصد و سطح دسترسی را مشخص کن. فایل‌های محیط، کلیدها و اطلاعات خصوصی نباید همراه کد عمومی فرستاده شوند. پیش از ثبت تغییرات، تفاوت فایل‌ها را ببین.
بعد از انتشار، بیرون از پیش‌نمایش تست کن
نشانی عمومی را در پنجره‌ای جدا باز کن. تصاویر، مسیرهای داخلی و کار اصلی را بررسی کن. اگر مشکلی پیدا شد، نسخهٔ منتشرشده و راه بازگشت را مشخص کن و مشکل را با نشانی و مراحل تکرار گزارش بده.
تمرین قدم‌به‌قدم
پیش‌نمایش، اتصال مخزن و انتشار عمومی را جدا بررسی می‌کنی تا نتیجهٔ واقعی روشن باشد.
سناریوی اصلی را در پیش‌نمایش اجرا کن
از صفحهٔ اول تا نتیجهٔ مورد نظر حرکت کن. فرم را با دادهٔ آزمایشی، لینک‌ها را با کلیک و نمای موبایل را با عرض کوچک امتحان کن.
مقصد و دامنه را تأیید کن
مشخص کن خروجی فقط پیش‌نمایش است یا باید عمومی شود. نام و آدرس مقصد را پیش از اقدام ببین. وجود دکمه یا پیام موفقیت به معنی فعال‌شدن همهٔ اتصال‌ها نیست.
مخزن را جدا بررسی کن
اگر اتصال GitHub در محیطت ارائه می‌شود، حساب و مخزن انتخابی را ببین. ذخیرهٔ کد در مخزن و انتشار سایت دو نتیجهٔ متفاوت‌اند و باید جدا تأیید شوند.
آدرس عمومی را باز کن
پس از انتشار، آدرس نهایی را بیرون از محیط سازنده باز کن. صفحهٔ اصلی، تصاویر، فرم‌ها و مسیرهای اصلی را دوباره بررسی کن و روش برگشت به نسخهٔ قبلی را نگه دار.
رفع مشکل: از نشانه تا راه‌حل
از نشانهٔ مشخص شروع کن و هر بار یک علت را بررسی کن. این راه‌ها را پیش از تکرار کامل کار امتحان کن.
| نشانه | چه کار کنم؟ |
|---|---|
| پیش‌نمایش خوب است اما آدرس عمومی نه | آدرس و نسخهٔ منتشرشده را مقایسه کن. تغییر در پیش‌نمایش ممکن است هنوز منتشر نشده باشد؛ وضعیت انتشار را ببین. |
| فرم ظاهر دارد اما نتیجه ندارد | رفتار فرم و اتصال آن باید جدا آزمایش شود. طراحی یک فرم به‌تنهایی به معنی ذخیره یا ارسال اطلاعات نیست. |
| مخزن اشتباه انتخاب شده | قبل از نوشتن یا انتشار، اتصال و مقصد را اصلاح کن. نام مخزن و حساب را با دقت بررسی کن. |
نمونهٔ درخواست برای این تمرین
این متن را با اطلاعات و محدودیت‌های خودت کامل کن.
این کار را خودت انجام بده.
- مسیر اصلی و موبایل بررسی شده‌اند.
- دادهٔ نمونه و اتصال واقعی روشن‌اند.
- مقصد انتشار یا مخزن مشخص است.
- نشانی عمومی جداگانه آزمایش می‌شود.
پرسش‌های رایج
دیدن پیش‌نمایش یعنی سایت منتشر شده؟
نه. پیش‌نمایش برای بازبینی است. انتشار را با وضعیت عملیات و بازشدن نشانی عمومی در یک پنجرهٔ مستقل بررسی کن.
در انجام این کار به مشکل خوردی؟
از پشتیبانی کمک بگیر