آمادهکردن اپ قابل نصب فروشگاه
نام و هویت اپ را تنظیم کنید، شناسهٔ پایدار انتخاب کنید، نسخهٔ لینوکس بسازید و خطا یا فایل خروجی را پیگیری کنید.
اپ فروشگاه در /panel/app نسخهای با نام و نشان فروشگاه شما آماده میکند تا مشتری بتواند ویترین را در قالب یک برنامهٔ قابل نصب باز کند. این بخش را با اپ مدیریت فروشگاه یا پنل کارکنان اشتباه نگیرید: خروجی برای دسترسی به فروشگاه مشتری است، نه برای مدیریت سفارشها. صفحهٔ فعلی پیشنمایش و ساخت نسخهٔ لینوکس را نشان میدهد؛ وجود نام Android در تنظیمات داخلی به معنی در دسترس بودن دکمهٔ ساخت Android در این صفحه نیست.
پیش از تنظیم اپ
اول آدرس و محتوای فروشگاه را آماده کنید. اپ به همان فروشگاهی پیوند میدهد که در پیشنمایش و دکمهٔ «مشاهدهٔ فروشگاه» میبینید؛ بنابراین صفحهٔ اصلی، نام، لوگو و دامنه را در پنل فروشنده بررسی کنید. اگر آدرس فروشگاه هنوز آزمایشی است، قبل از فرستادن فایل نصب برای مشتریها مشخص کنید که قرار است کدام نشانی در دسترس آنها باشد.
در این صفحه تنظیمهای هویت اپ و ساخت فایل در یک فرم کنار هم هستند. تغییر فرم تا وقتی «ذخیره تنظیمات» را نزدهاید، فقط در پیشنمایش همان صفحه دیده میشود. با زدن «ساخت نسخه لینوکس»، تنظیمهای فرم ابتدا ذخیره میشوند و بعد درخواست ساخت وارد صف میشود. اگر ذخیره ناموفق باشد، ساخت هم آغاز نمیشود.
تنظیم نام، نسخه و شناسه
نام اپ
نامی را بنویسید که مشتری باید در پیشنمایش و برنامهٔ نصبشده تشخیص دهد؛ معمولاً نام کوتاه فروشگاه کافی است. این نام جای نام حقوقی شرکت یا توضیح امکانات نیست. پس از تغییر، پیشنمایش سمت چپ/راست فرم را بررسی کنید تا نام در کارت باریک نشده باشد.
نسخه
نسخه شناسهٔ خواندنی انتشار است، مانند 1.2.0. برای اصلاح کوچک، شمارهای انتخاب کنید که با فایل قبلی اشتباه نشود. فیلد با جهت چپبهراست نمایش داده میشود؛ پیش از ساخت، نسخه را با روشی که تیم شما برای تحویل فایل دارد هماهنگ کنید. صفحه نسخهٔ واردشده را در سابقه ساخت ذخیره میکند.
شناسهٔ اپ
این شناسه مقدار فنی ثابتی برای هویت برنامه است؛ آن را با نام نمایشی یکی نگیرید. پیش از اولین ساخت، شناسهای انتخاب کنید که متعلق به همین فروشگاه باشد و بعداً نیاز به عوضکردنش نداشته باشید. پس از اولین ساخت موفق، فیلد قفل میشود تا بهروزرسانیهای بعدی همچنان ادامهٔ همان اپ شناخته شوند. تغییر نام نمایشی، راه تغییر شناسه نیست.
توضیح کوتاه و توضیح اپ
توضیح کوتاه برای معرفی فشردهٔ اپ است و توضیح بلند فضای بیشتری برای معرفی کاربرد آن دارد. روشن بنویسید این برنامه راه دسترسی به فروشگاه و خرید از آن است؛ وعدهای دربارهٔ قابلیتهایی که در خود ویترین وجود ندارد ندهید. متن مشتریپسند بنویسید و اطلاعات خصوصی، نشانی داخلی یا کلید اتصال را داخل توضیح قرار ندهید.
انتخاب آیکن
اگر آیکن اختصاصی تنظیم نکردهاید، صفحه از لوگوی فعلی فروشگاه استفاده میکند. برای آیکن جدا، فایل PNG، JPEG یا WebP با حجم حداکثر ۴ مگابایت انتخاب کنید. پیشنمایش بلافاصله آیکن انتخابشده را کنار نام و نسخه نشان میدهد؛ قبل از ذخیره، خوانایی آن را در قاب کوچک بررسی کنید. انتخاب فایل به تنهایی آن را ذخیره نمیکند؛ «ذخیره تنظیمات» یا «ساخت نسخه لینوکس» را بزنید.
دکمهٔ «استفاده از لوگوی فروشگاه» آیکن اختصاصی را پاک میکند و لوگوی جاری فروشگاه را جایگزین آن میکند. این کار لوگوی فروشگاه را حذف یا تغییر نمیدهد. اگر لوگوی فروشگاه را بعداً عوض کنید و گزینهٔ استفاده از لوگوی فروشگاه فعال باشد، همان لوگو منبع آیکن اپ است.
ذخیره و ساخت نسخهٔ لینوکس
۱. نام، نسخه و توضیحها را بازبینی کنید؛ شناسهٔ اپ را با دقت انتخاب کنید، چون پس از ساخت موفق قفل خواهد شد.
۲. آیکن اختصاصی را انتخاب کنید یا استفاده از لوگوی فروشگاه را نگه دارید.
۳. «ذخیره تنظیمات» را بزنید. پیام موفقیت را بخوانید و مطمئن شوید فرم مقدارهای تازه را نشان میدهد.
۴. کارت وضعیت ساخت را بررسی کنید. اگر سرویس ساخت خاموش باشد یا پلتفرم لینوکس آماده نباشد، دکمهٔ ساخت غیرفعال است؛ چند بار کلیککردن این محدودیت را رفع نمیکند.
۵. «ساخت نسخه لینوکس» را انتخاب کنید. سیستم فرم جاری را ذخیره و سپس ساخت را صفبندی میکند. تا پایان ساخت دیگری آغاز نمیشود.
۶. در بخش «نسخههای ساختهشده» پیشرفت و مرحله را دنبال کنید. صفحه هنگام ساخت فعال، وضعیت را خودکار تازه میکند؛ دکمهٔ تازهسازی هم فهرست را دستی دوباره میخواند.
۷. فقط وقتی وضعیت «آماده دانلود» شد، فایل Linux را دریافت کنید. نام فایل و مقدار SHA-256 را در سابقه همان ردیف ببینید و برای کنترل یکپارچگی فایل، checksum را همراه فایل به تیم فنی تحویل دهید.
معنی وضعیتهای ساخت
- در صف ساخت: درخواست پذیرفته شده و منتظر نوبت است.
- آمادهسازی، در حال ساخت، در حال ذخیره خروجی: کار هنوز تمام نشده است. درصد و نام مرحله را دنبال کنید؛ در این حالت نسخه آماده دانلود نیست.
- آماده دانلود: ساخت موفق بوده و اگر فایل خروجی موجود باشد، دکمهٔ دانلود نمایش داده میشود. شناسهٔ اپ پس از این موفقیت قفل میشود.
- ساخت ناموفق: جزئیات را در «جزئیات خطا» باز کنید. متن خطا و بخش انتهایی گزارش برای تشخیص مشکل است؛ آن را بدون بررسی به مشتری نفرستید.
- لغوشده: این وضعیت در سابقه نمایش داده میشود؛ صفحهٔ فعلی دکمهٔ لغو یا تلاش مجدد مستقلی نشان نمیدهد. اگر ساخت فعالی باقی نمانده، پس از بررسی تنظیمها درخواست ساخت تازه ثبت کنید.
اگر سرویس ساخت روی سرور فعال نباشد، اطلاعات هویت اپ همچنان قابل مشاهده است اما فایل ساخته نمیشود. این وضعیت با خطای موقت یک اجرای مشخص فرق دارد: در اولی پشتیبانی باید وضعیت سرویس را بررسی کند؛ در دومی جزئیات همان ردیف ساخت راهنمای عیبیابی است.
سناریوی کامل و خطاهای رایج
فرض کنید فروشگاه شما نام و لوگوی تازه گرفته است. ابتدا نام فروشگاه و دامنه را در تنظیمات ویترین نهایی کنید؛ بعد به /panel/app برگردید، نام اپ و توضیحاتش را اصلاح کنید، آیکن اختصاصی را انتخاب و پیشنمایش را ببینید. نسخهٔ بعدی را وارد و تنظیمها را ذخیره کنید. اگر این اولین خروجی موفق است، شناسهٔ پایدار اپ را قبل از ساخت نهایی کنید. پس از آمادهشدن فایل، نسخه و checksum را ثبت کنید؛ فایل قدیمی را تا وقتی انتشار و دریافت نسخهٔ جدید را بررسی نکردهاید با نسخهٔ جدید جایگزین نکنید.
دکمهٔ ساخت غیرفعال است
بالای فرم بررسی کنید سرویس ساخت فعال و Linux در فهرست پلتفرمها موجود باشد. ساخت دیگری هم نباید در صف یا در حال اجرا باشد. اگر سرویس برای این سرور فعال نیست، منتظر تغییر فرم نمانید و موضوع را با مدیر فنی پیگیری کنید.
آیکن پذیرفته نمیشود
نوع فایل باید PNG، JPEG یا WebP باشد و اندازهاش از ۴ مگابایت بیشتر نباشد. فایل را به یکی از همین قالبها تبدیل کنید یا حجمش را پایین بیاورید؛ تغییر پسوند بدون تبدیل واقعی فرمت کافی نیست.
شناسه پس از ساخت قفل شده است
این قفل برای حفظ هویت اپ بعد از انتشار موفق است. پیش از اولین ساخت موفق، شناسه را بازبینی کنید. اگر اشتباه ثبت شده، از تغییر آن در نسخهٔ بعدی خودداری کنید و برای بررسی مسیر اصلاح هویت اپ از پشتیبانی راهنمایی بگیرید.
ساخت شکست خورده است
ردیف همان نسخه را باز کنید و بخش «جزئیات خطا» را بخوانید. نسخه، زمان ساخت، مرحله و پیام خطا را یادداشت کنید. پس از اصلاح علت، اگر ساخت قبلی فعال نیست یک درخواست جدید بفرستید؛ تکرار پیدرپی درخواستها بدون خواندن خطا، صف ساخت را شلوغ میکند.