Project IDX به شما امکان می دهد با ارائه یک نمای زنده از برنامه خود در کنار ویرایشگر کد، پیش نمایش کار خود را مشاهده کنید. پیش نمایش های وب IDX یک فریم درون خطی (iFrame) از وب سرور برنامه و یک شبیه ساز اندروید مبتنی بر ابر ارائه می دهد.
محیط پیش نمایش خود را فعال و پیکربندی کنید
برای پیش نمایش برنامه خود در فضای کاری خود، باید محیط پیش نمایش خود را پیکربندی کنید.
پیش نمایش ها را در فایل پیکربندی
.idx/dev.nix
خود فعال کنید. IDX هنگامی که یک فضای کاری جدید ایجاد می کنید به طور خودکار این فایل را تولید می کند و شامل هر محیط پیش نمایش قابل اجرا بر اساس الگوی انتخابی شما می شود. اگر فایل در مخزن کد IDX شما نیست، آن را ایجاد کنید. مشخصهidx.previews
را رویtrue
تنظیم کنید و ویژگی های پیکربندی را اضافه کنید، همانطور که در مثال زیر نشان داده شده است:{ pkgs, ... }: { # NOTE: This is an excerpt of a complete Nix configuration example. # For more information about the dev.nix file in IDX, see # https://developers.google.com/idx/guides/customize-idx-env # Enable previews and customize configuration idx.previews = { enable = true; previews = { # The following object sets web previews web = { command = [ "npm" "run" "start" "--" "--port" "$PORT" "--host" "0.0.0.0" "--disable-host-check" ]; manager = "web"; # Optionally, specify a directory that contains your web app # cwd = "app/client"; }; # The following object sets Android previews # Note that this is supported only on Flutter workspaces android = { manager = "flutter"; }; }; }; }
برای فهرست کامل ویژگیهای Nix در IDX، به Nix + IDX مراجعه کنید.
محیط خود را بازسازی کنید:
- دستور Project IDX: Hard restart را از پالت فرمان ( Cmd+Shift+P / Ctrl+Shift+P ) اجرا کنید.
- از اعلان به روز شده تنظیمات محیط، روی بازسازی محیط کلیک کنید.
هنگامی که پس از اصلاح فایل
dev.nix
خود، محیط را بازسازی میکنید، پانل پیشنمایش در فضای کاری شما ظاهر میشود که بسته به آنچه فعال کردهاید، تبهای اندروید و وب را نشان میدهد. با این حال، ممکن است لازم باشد مدتی صبر کنید تا محیط بازسازی شود. سعی کنید فضای کاری را ببندید و سپس آن را از داشبورد IDX دوباره باز کنید.
از پیش نمایش برنامه ها استفاده کنید
IDX پیشنمایشهای وب را در شبیهسازهای Chrome و Android (در فضاهای کاری Flutter) ارائه میکند که برنامه شما را در محیط پیشنمایش نصب میکنند، بنابراین میتوانید آن را به طور کامل، از انتهای تا انتها، مستقیماً از فضای کاری خود آزمایش کنید.
بازخوانی پیش نمایش ها برای وب و اندروید
IDX به قابلیتهای بارگذاری مجدد داغ فریمورکهای زیرین (مانند npm run start
و flutter hot-reload
) متصل میشود تا یک حلقه توسعه درونی فشرده را به شما ارائه دهد. این بخش انواع مختلف بارگیریها را پوشش میدهد تا به شما کمک کند اگر رفتار پیشفرض در IDX برای مورد استفاده شما خوب کار نمیکند، عیبیابی کنید.
بارگذاری مجدد خودکار : بارگذاری مجدد داغ به طور خودکار هنگامی که یک فایل را ذخیره می کنید انجام می شود. گاهی اوقات به عنوان Hot Module Replacement (یا HMR) شناخته می شود، یک بارگذاری مجدد داغ برنامه شما را بدون بارگیری مجدد صفحه (برای برنامه های وب) یا بدون راه اندازی مجدد یا نصب مجدد برنامه (برای شبیه سازها) به روز می کند. این رویکرد برای حفظ حالت زنده برنامه شما عالی است، اما ممکن است گاهی اوقات آنطور که در نظر گرفته شده کار نکند.
بارگذاری مجدد دستی کامل : این گزینه معادل به روز رسانی صفحه (برای برنامه های وب) یا راه اندازی مجدد برنامه (برای شبیه سازها) است. توصیه می کنیم از یک بارگذاری مجدد کامل برای ثبت تغییرات قابل توجه در کد منبع خود استفاده کنید، مانند زمانی که تکه های بزرگی از کد را دوباره فاکتور می کنید.
راه اندازی مجدد دستی سخت : این گزینه یک راه اندازی مجدد کامل سیستم پیش نمایش IDX را انجام می دهد که شامل توقف و راه اندازی مجدد وب سرور برنامه شما می شود.
همه گزینههای بارگیری مجدد با استفاده از نوار ابزار پیشنمایش یا پالت فرمان ( Cmd+Shift+P در Mac یا Ctrl+Shift+P در ChromeOS، Windows یا Linux)، در دسته IDX در دسترس هستند.
برای استفاده از نوار ابزار پیش نمایش، مراحل زیر را دنبال کنید:
برای بازخوانی صفحه، روی نماد بارگذاری مجدد کلیک کنید. این باعث بارگذاری مجدد کامل می شود. برای نوع دیگری از تازهسازی، روی فلش کنار نماد بارگیری مجدد کلیک کنید تا منو بزرگ شود.
گزینه refresh مورد نظر خود را از منو انتخاب کنید: Hot Reload ، Full Reload یا Hard Restart .
پیش نمایش وب خود را با دیگران به اشتراک بگذارید
میتوانید با فعال کردن دسترسی و سپس اشتراکگذاری پیوند مستقیم به پیشنمایش، پیشنمایش وب برنامهتان را برای بازخورد با دیگران به اشتراک بگذارید:
در نوار ابزار پیش نمایش وب، روی نماد پیوند پیشنمایش را به اشتراک بگذارید ، در سمت راست نوار آدرس برای باز کردن منوی اشتراکگذاری.
با استفاده از یکی از این گزینهها به دیگران اجازه دسترسی به فضای کاری شما را بدهید:
گزینه A : با انتخاب ساختن پیش نمایش عمومی، پیش نمایش فضای کاری خود را برای عموم در دسترس قرار دهید. این به هر کسی در اینترنت امکان میدهد تا زمانی که فضای کاری شما فعال است و تا زمانی که دسترسی عمومی را خاموش نکنید، به سرور پیشنمایش در حال اجرا فضای کاری شما دسترسی پیدا کند.
گزینه ب . با انتخاب مدیریت دسترسی به فضای کاری ، فقط با افرادی که میخواهید به آنها دسترسی داشته باشید، فضای کاری خود را به اشتراک بگذارید.
Copy Preview URL را برای کپی کردن یک پیوند مستقیم به پیشنمایش فضای کاری انتخاب کنید، سپس میتوانید آن را برای کسانی که میخواهید بازخورد دریافت کنید ارسال کنید.
ذخیره خودکار و بارگذاری مجدد داغ را پیکربندی کنید
به طور پیشفرض، IDX کار شما را یک ثانیه پس از توقف تایپ ذخیره میکند و بارگذاری مجدد خودکار را آغاز میکند. اگر می خواهید IDX کار شما را در فاصله زمانی متفاوت ذخیره کند، تنظیمات ذخیره خودکار را تغییر دهید. همچنین می توانید ذخیره خودکار را خاموش کنید.
ذخیره خودکار را پیکربندی کنید
- Project IDX را باز کنید.
- روی نماد تنظیمات کلیک کنید. پنجره تنظیمات ظاهر می شود.
- جستجوی فایلها: ذخیره خودکار و بررسی اینکه فیلد روی «afterDelay» تنظیم شده است.
- جستجوی فایلها: تأخیر ذخیره خودکار قسمت Auto Save Delay ظاهر می شود.
- یک بازه تأخیر ذخیره خودکار جدید، که بر حسب میلی ثانیه بیان می شود، وارد کنید. تغییرات کار شما اکنون به طور خودکار بر اساس تنظیم تأخیر ذخیره خودکار جدید ذخیره می شود.
ذخیره خودکار را خاموش کنید
- Project IDX را باز کنید.
- روی نماد تنظیمات کلیک کنید. پنجره تنظیمات ظاهر می شود.
- جستجو برای فایل ها: ذخیره خودکار .
- روی منوی کشویی کلیک کنید و خاموش را انتخاب کنید. ذخیره خودکار اکنون غیرفعال است.