سوالات متداول و عیب یابی

این صفحه پاسخ به سوالات متداول (FAQs) در مورد App Hosting را ارائه می‌دهد.

سوالات متداول App Hosting

آیا App Hosting از فریم‌ورک‌هایی غیر از Next.js و Angular پشتیبانی می‌کند؟

App Hosting پشتیبانی از ساخت و استقرار از پیش پیکربندی‌شده برای Next.js و Angular را ارائه می‌دهد، که در آن ما متعهد به درک این چارچوب‌ها و تفسیر پیکربندی‌های بومی آنها شده‌ایم. برای تعدادی از چارچوب‌های دیگر ، جامعه توسعه‌دهندگان از آداپتورهای چارچوب App Hosting پشتیبانی می‌کند. علاوه بر این، برای هر برنامه Node.js با اسکریپت ساخت و شروع، App Hosting سعی در ساخت خواهد کرد، اما نمی‌تواند به طور قابل اعتمادی موفقیت را تضمین کند. به ادغام چارچوب مراجعه کنید.

Firebase App Hosting از کدام مناطق پشتیبانی می‌کند؟

مناطق App Hosting احتمالاً به مرور زمان گسترش خواهند یافت. برای به‌روزترین اطلاعات ، به مکان‌های App Hosting مراجعه کنید.

آیا می‌توانم علاوه بر گیت‌هاب، از گیت‌لب یا سایر ارائه‌دهندگان گیت برای استقرار استفاده کنم؟

در حال حاضر نمی‌توانید، اما پشتیبانی از سایر ارائه‌دهندگان در نقشه راه بلندمدت App Hosting قرار دارد.

چرا نمی‌توانم مخزن خود را در رابط کاربری کنسول Firebase پیدا کنم؟

اگر مخزن شما هنگام ایجاد یک backend جدید در کنسول Firebase در لیست گزینه‌ها ظاهر نمی‌شود، ابتدا Refresh list را انتخاب کنید. اگر مخزن مورد نظر هنوز در دسترس نیست، ممکن است لازم باشد آن را با استفاده از گزینه اعطای دسترسی به یک مخزن جدید در GitHub اضافه کنید.

علاوه بر این، می‌توانید مخازن را با برنامه Firebase App Hosting GitHub مدیریت کنید. برای انجام این کار، به پروفایل GitHub خود بروید و تنظیمات و سپس برنامه‌ها را انتخاب کنید. در ردیف جدول برنامه Firebase App Hosting ، برای مدیریت مخازن، روی پیکربندی کلیک کنید.

چرا سایت من در برنامه وب ویو موبایل اندروید به طور عادی نمایش داده نمی‌شود؟

برنامه‌هایی که قبل از سه‌ماهه سوم ۲۰۲۵ یک دامنه سفارشی را با کنسول Firebase پیکربندی کرده‌اند، ممکن است متوجه شوند که سایت در Android WebView به درستی نمایش داده نمی‌شود. این اتفاق به این دلیل رخ می‌دهد که رکوردهای CNAME مورد استفاده در آن دوره با Android WebView سازگار نبوده‌اند.

برای حل این مشکل، دامنه سفارشی را از پنل مدیریت App Hosting حذف کرده و دوباره اضافه کنید. رابط کاربری کنسول به‌روزرسانی‌شده، ۳ رکورد جدید، یک رکورد A و یک رکورد TXT برای دامنه و یک CNAME برای زیردامنه چالش ACME (برای گواهی‌ها) ارائه می‌دهد؛ از این رکوردها به جای رکورد CNAME قبلی استفاده کنید.

چگونه می‌توانم مخزن مرتبط با پروژه App Hosting خود را تغییر دهم؟

در حال حاضر، تغییر مخزن امکان‌پذیر نیست. با این حال، می‌توانید یک backend جدید مرتبط با مخزن مورد نظر در همان پروژه ایجاد کنید، یا یک backend جدید در یک پروژه جداگانه ایجاد کنید.

چگونه می‌توانم برای سایت App Hosting هدر تنظیم کنم؟

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

آیا شبیه‌ساز برای توسعه محلی با App Hosting وجود دارد؟

بله، شما می‌توانید قبل از استقرار App Hosting ، با استفاده از شبیه‌ساز App Hosting که بخشی از مجموعه شبیه‌ساز محلی Firebase است، آزمایش‌های محلی برنامه خود را انجام دهید. به بخش Locally test your app deployment مراجعه کنید.

چرا در App Hosting خطا می‌بینم اما در Cloud Build نه؟

در چنین مواردی، ممکن است خطای شما از Cloud Run ناشی شده باشد. برای اطمینان، وضعیت انتشار را بررسی کنید.

چگونه می‌توانم یک حساب کاربری GitHub لینک‌شده را تغییر دهم یا حذف کنم؟

برای حذف حساب کاربری GitHub لینک‌شده، Developer Connect را باز کنید، مطمئن شوید که پروژه شما انتخاب شده است و اتصال firebase-app-hosting-github-oath و اتصالی که با apphosting-github-conn- شروع می‌شود را حذف کنید. وقتی App Hosting در کنسول Firebase باز می‌کنید، اکنون باید بتوانید یک اتصال GitHub جدید راه‌اندازی کنید.

چگونه می‌توانم کوکی‌ها را برای سایت App Hosting خود تنظیم کنم؟

اگرچه در زمان راه‌اندازی پیش‌نمایش App Hosting در دسترس نبود، اما هدر پاسخ HTTP Set-Cookie اکنون مطابق انتظار کار می‌کند.

محدودیت‌های عمومی App Hosting و عیب‌یابی

• به دلیل مشکلی در زیرساخت Cloud Run ، ایجاد یا به‌روزرسانی منابع ممکن است در برخی مناطق مانند us-central1 کندتر از حد انتظار باشد. اگر تأخیر در استقرار در یک منطقه خاص مشکل‌ساز است، گوگل توصیه می‌کند که در منطقه دیگری مستقر شوید.
• CDN مربوط به App Hosting فقط می‌تواند مجموعه‌ای خاص از هدرهای درخواست را در کلیدهای حافظه پنهان خود قرار دهد. این لیست شامل هدرهای RSC ، Next-Router-State-Tree ، Next-Router-Prefetch ، Next-Router-Segment-Prefetch و Next-Url مربوط به NextJS و همچنین هدرهای استاندارد Accept ، Accept-Encoding ، Access-Control-Request-Headers ، Access-Control-Request-Method ، Origin ، Sec-Fetch-Dest ، Sec-Fetch-Mode ، Sec-Fetch-Site ، X-Goog-Allowed-Resources و X-Origin مربوط به Cloud CDN می‌شود. اگر پاسخی حاوی هدر Vary با مقداری باشد که در اینجا ذکر نشده است، CDN ما آن را ذخیره نمی‌کند.
• فایل‌های استاتیک ذخیره نشده از Cloud Run ارائه می‌شوند؛ در نسخه بعدی، برای عملکرد بهتر، این فایل‌ها از مبدا App Hosting ذخیره و ارائه خواهند شد.
• کنسول Firebase ممکن است به طور متناوب خطای "ساخت یافت نشد و نامعتبر است" را در هنگام ایجاد بک‌اند نشان دهد.
• همه backend های یک پروژه، یک حساب GitHub org/account مشترک دارند. آنها می‌توانند به مخازن مختلف تحت آن org/account متصل شوند. برای ایجاد backend هایی که به حساب‌های GitHub مختلف متصل هستند، آنها را در پروژه‌های جداگانه قرار دهید.

محدودیت‌های برنامه‌های Angular و عیب‌یابی آن‌ها

اگرچه پشتیبانی App Hosting برای Angular به طور فعال در حال توسعه و گسترش است، اما محدودیت‌های زیر را دارد:

• I18n : در حالی که قابلیت‌های اصلی I18n کار می‌کنند، پیمایش مستقیم به صفحات SSR می‌تواند منجر به خطا شود.
• بومی‌سازی : ساخت نسخه برای زبان‌های مختلف پشتیبانی نمی‌شود.
• سازندگان : در حال حاضر فقط سازنده برنامه پشتیبانی می‌شود.
• محیط‌ها و ابزارهای مونوریپو : پروژه‌های انگولار که بیش از یک هدف کاربردی واحد دارند، با شکست مواجه خواهند شد. برای پشتیبانی کامل‌تر از مونوریپو، از Nx استفاده کنید.

خطاهای HTTP 400 و اعتماد به پروکسی در Angular SSR

اگر برنامه Angular شما که روی Firebase App Hosting مستقر شده است با خطاهای HTTP 400 (درخواست بد)، مسدودکننده‌های اعتبارسنجی میزبان یا خرابی‌های اعتماد پروکسی مواجه می‌شود، راه‌حل پیشنهادی برای نسخه Angular خود را دنبال کنید:

• نسخه‌های ۱۹، ۲۰ و ۲۱ انگولار : شما دو راه برای حل این خطاهای HTTP 400 دارید:
  • ارتقاء وابستگی‌ها: برای نصب آخرین نسخه پچ برای نسخه فعلی انگولار خود npm update @angular/core @angular/ssr را اجرا کنید.
  • پیکربندی دستی: با تنظیم trustProxyHeaders: true در پیکربندی سرور خود، یک جایگزین پیکربندی در سطح کد اعمال کنید ( به بخش پیکربندی هدرهای پروکسی قابل اعتماد در مستندات Angular مراجعه کنید).
• Angular نسخه ۲۲ : اولین ساخت روی یک backend جدید ممکن است خطای ۴۰۰ را برگرداند. برای حل این مشکل، یک ساخت دوم ایجاد کنید. همه ساخت‌های بعدی باید طبق برنامه کار کنند.

محدودیت‌ها و عیب‌یابی Next.js

• به طور پیش‌فرض، بهینه‌سازی تصویر NextJS داخلی در App Hosting غیرفعال است، مگر اینکه صریحاً images.unoptimized را روی false تنظیم کنید یا از یک Image Loader سفارشی استفاده کنید. به Optimize image loading در Next.js مراجعه کنید.
• مسیرهای URL حاوی کاراکترهای کدگذاری شده با درصد توسط Cloud Run رمزگشایی می‌شوند. این ممکن است باعث ایجاد مشکلاتی در ویژگی‌هایی شود که فقط مسیرهای URL کدگذاری شده را انتظار دارند، مانند مسیریابی موازی Next.js.
• در حال حاضر، App Hosting ذخیره‌سازی موقت (caching) را برای برنامه‌های NextJS که از میان‌افزار استفاده می‌کنند، محدود می‌کند. با گذشت زمان، نرخ موفقیت در ذخیره‌سازی موقت (cache hit) باید بهبود یابد.
• مسیرهای URL حاوی کاراکترهای کدگذاری شده با درصد توسط Cloud Run رمزگشایی می‌شوند. این ممکن است باعث ایجاد مشکلاتی در ویژگی‌هایی شود که فقط مسیرهای URL کدگذاری شده را انتظار دارند، مانند مسیریابی موازی Next.js.