کاربرد فایل lunchsetting.json در پروژه های Asp.net core چیست ؟

کاربرد فایل lunchsetting.json در Asp.net core

این فایل معمولا در پنجره Solution Explorer و در پوشه Properties قابل مشاهده می باشد.

برخی کاربردهای فایل lunchsettings.json

• این فایل یک فایل مربوط به پیکربندی و تنظیمات پروژه موقع شروع پروژه می باشد.
• یکی از کاربردهای فایل lunchsettings.json این می باشد که نحوه ره اندازی پروژه را مشخص می کند.
• در این فایل می توان برای راه اندازی پروژه حالات مختلفی را ایجاد و پیکربندی کرد. به عنوان مثال می توان برای راه اندازی پروژه روی سرور IIS یا Kestrel و یا اجرا توسط HTTP یا HTTPs تنظیمات مختلف را انجام داد. همچنین می توان مشخص کرد پروژه موقع ران شدن کدام پورت را استفاده کند. مهم ترین مزیت این قابلیت این می باشد که برنامه نویس به راحتی و بدون تغییر کد می تواند بین حالات مختلف و سرورهای مختلف پروژه خود را تست کند.

چه تنظیماتی در فایل lunchsettings.json قابل انجام است

• پیکربندی پروفایل (Profile Configuration) : یکی از تنظیمانی که در این فایل قابل انجام است این است که می توانید چندین پروفایل را برای سناریوهای مختلف تعریف کنید (به عنوان مثال، اجرا با IIS Express، Kestrel، یا استفاده از هر دو IIS و Kestrel).
• متغیرهای محیطی (Environment Variables) : در این فایل می توانید متغیرهای محیطی یا سراسری را مشخص می‌کند که هنگام اجرای برنامه در دسترس هستند.
• URL های برنامه (Application URLs) : در این فایل می توانید آدرس هایی را تایین کنید که برنامه در طول توسعه به آنها گوش می دهد. مثلا ممکن است در برخی بخش های برنامه نیاز به فراخوانی یک api مشخص باشد. می توانید آدرس این Api را یکبار در این فایل تعریف کنید و بارها از آن استفاده کنید.
• راه‌اندازی مرورگر (Launch Browser) : این تنظیم تعیین می‌کند که آیا مرورگر باید به‌طور خودکار هنگام شروع برنامه راه‌اندازی شود یا خیر و کدام URL باید باز شود.

نکته مهم : نکته بسیار مهم در مورد فایل lunchsettings.json این می باشد که این فایل فقط موقع توسعه نرم افزار و در محیط ویژوال استودیو یا VS Code قابل دسترس می باشد و بعد از انتشار پروژه روی هاست در دسترس نمی باشد. بنابراین اگر تنظیماتی دارید که نیاز دارید بعد از استقرار و انتشار نرم افزار روی هاست تغییراتی داشته باشند بهتر است این تنظیمات را در فایل appsetting.json قرار بدهید.

به طور پیش فرض یک پروژه Asp.net Core دارای یک فایل lunchsettings.json به صورت زیر می باشد.

{
  "$schema": "http://json.schemastore.org/launchsettings.json",
  "iisSettings": {
    "windowsAuthentication": false,
    "anonymousAuthentication": true,
    "iisExpress": {
      "applicationUrl": "http://localhost:20366",
      "sslPort": 44336
    }
  },
  "profiles": {
    //تنظیمات این بخش توسط سرور Kestrel استفاده می شود
    "http": {
      "commandName": "Project",
      "dotnetRunMessages": true,
      "launchBrowser": true,
      "applicationUrl": "http://localhost:5265",
      "environmentVariables": {
        "ASPNETCORE_ENVIRONMENT": "Development"
      }
    },
    "https": {
      "commandName": "Project",
      "dotnetRunMessages": true,
      "launchBrowser": true,
      "applicationUrl": "https://localhost:7006;http://localhost:5265",
      "environmentVariables": {
        "ASPNETCORE_ENVIRONMENT": "Development"
      }
    },
    //تنظیمات این بخش توسط سرور IIS استفاده می شود
    "IIS Express": {
      "commandName": "IISExpress",
      "launchBrowser": true,
      "environmentVariables": {
        "ASPNETCORE_ENVIRONMENT": "Development"
      }
    }
  }
}

برای کسب اطلاعات بیشتر و اینکه دقیقا بدونید هر کدام این این بلوک ها چه کاربردی دارند می تونید لینک زیر رو هم مطالعه کنید.

ASP.NET Core LaunchSettings.json File