إشعار
يتطلب الوصول إلى هذه الصفحة تخويلاً. يمكنك محاولة تسجيل الدخول أو تغيير الدلائل.
يتطلب الوصول إلى هذه الصفحة تخويلاً. يمكنك محاولة تغيير الدلائل.
تتميز Azure Static Web Apps بمكانين مختلفين حيث يكون وقت التشغيل وإصدارات اللغة مهمة، على الواجهة الأمامية وواجهة برمجة التطبيقات.
| نوع وقت التشغيل | وصف |
|---|---|
| الواجهة الأمامية | الإصدار المسؤول عن تشغيل خطوات بناء موقع الويب التي تنشئ تطبيق الواجهة الأمامية. |
| API | إصدار ووقت تشغيل Azure Functions المستخدمة في تطبيق الويب الخاص بك. |
الواجهة الأمامية
يمكنك تحديد الإصدار المستخدم لإنشاء الواجهة الأمامية لتطبيق الويب الثابت. غالبا ما يكون تكوين إصدار غير افتراضي ضروريا فقط إذا كنت بحاجة إلى استهداف الإصدارات القديمة.
يمكنك تحديد إصدار وقت التشغيل الذي ينشئ الواجهة الأمامية لتطبيق الويب الثابت في ملف package.json في engines قسم من الملف.
{
...
"engines": {
"node": ">=14.0.0"
}
}
واجهة برمجة التطبيقات (API)
يتم توفير الدعم الأساسي لواجهات برمجة التطبيقات في Azure Static Web Apps بواسطة Azure Functions. راجع اللغات ووقت التشغيل المعتمدين في Azure Functions للحصول على التفاصيل.
يتم دعم الإصدارات التالية للوظائف المدارة في Static Web Apps. إذا كان تطبيقك يتطلب إصدارا غير مدرج، ففكر في إحضار الوظائف الخاصة بك إلى تطبيقك.
لتكوين إصدار وقت تشغيل لغة واجهة برمجة التطبيقات، قم بتعيين الخاصية apiRuntime في platform القسم إلى إحدى القيم المدعومة التالية.
| إصدار وقت تشغيل اللغة | نظام التشغيل | إصدار Azure Functions |
apiRuntime قيمة |
تاريخ انتهاء الدعم |
|---|---|---|---|---|
| .NET Core 3.1 | بالنسبة لنظام التشغيل | 3.x | dotnet:3.1 |
3 ديسمبر 2022 |
| .NET 6.0 قيد المعالجة | بالنسبة لنظام التشغيل | 4.x | dotnet:6.0 |
30 أبريل 2025 |
| .NET 8.0 قيد المعالجة | بالنسبة لنظام التشغيل | 4.x | dotnet:8.0 |
- |
| .NET 6.0 معزول | بالنسبة لنظام التشغيل | 4.x | dotnet-isolated:6.0 |
30 أبريل 2025 |
| .NET 7.0 معزول | بالنسبة لنظام التشغيل | 4.x | dotnet-isolated:7.0 |
30 أبريل 2025 |
| .NET 8.0 معزول | بالنسبة لنظام التشغيل | 4.x | dotnet-isolated:8.0 |
- |
| .NET 9.0 معزول | بالنسبة لنظام التشغيل | 4.x | dotnet-isolated:9.0 |
- |
| Node.js 12.x | Linux | 3.x | node:12 |
3 ديسمبر 2022 |
| Node.js 14.x | Linux | 4.x | node:14 |
30 أبريل 2025 |
| Node.js 16.x | Linux | 4.x | node:16 |
30 أبريل 2025 |
| Node.js 18.x | Linux | 4.x | node:18 |
31 مايو 2025 |
| Node.js 20.x | Linux | 4.x | node:20 |
- |
| برنامج Python 3.8 | Linux | 4.x | python:3.8 |
30 أبريل 2025 |
| Python 3.9 | Linux | 4.x | python:3.9 |
- |
| Python 3.10 | Linux | 4.x | python:3.10 |
- |
| Python 3.11 | Linux | 4.x | python:3.11 |
- |
.صافي
لتغيير إصدار وقت التشغيل في تطبيق .NET، قم بتغيير TargetFramework القيمة في ملف csproj . على الرغم من أنه اختياري، إذا قمت بتعيين قيمة في apiRuntime، فتأكد من تطابق القيمة مع ما تحدده في ملف csproj.
يوضح المثال التالي كيفية تحديث TargetFramework عنصر NET 8.0 كإصدار وقت تشغيل لغة API في ملف csproj .
<Project Sdk="Microsoft.NET.Sdk">
<PropertyGroup>
<TargetFramework>net8.0</TargetFramework>
...
</PropertyGroup>
...
Node.js
يوضح تكوين المثال التالي كيفية استخدام الخاصية apiRuntime لتحديد Node.js 20 كإصدار وقت تشغيل لغة API في ملف staticwebapp.config.json .
{
...
"platform": {
"apiRuntime": "node:20"
}
...
}
بايثون
يوضح تكوين المثال التالي كيفية استخدام الخاصية apiRuntime لتحديد Python 3.11 كإصدار وقت تشغيل لغة واجهة برمجة التطبيقات في ملف staticwebapp.config.json .
{
...
"platform": {
"apiRuntime": "python:3.11"
}
...
}
إعادة تمكين الوكلاء في v4.x
تدعم Azure Functions إعادة تمكين الوكلاء في v4.x. لتمكين دعم الوكيل في الوظائف المدارة لتطبيق الويب الثابت، قم بتعيين SWA_ENABLE_PROXIES_MANAGED_FUNCTIONS إلى true في إعدادات التطبيق الخاص بك.
إشعار
بينما يتم دعم الوكلاء في v4.x، ضع في اعتبارك استخدام تكامل Azure API Management مع تطبيقات الوظائف المدارة، لذلك لا يعتمد تطبيقك على الوكلاء.
عمليات الإهلاك
إشعار
الآن بعد إيقاف Azure Functions v3، تستخدم Static Web Apps Azure Functions v4 لدعم وقت تشغيل واجهة برمجة التطبيقات ل Python 3.8. أعد نشر تطبيقك لتمكين هذا التغيير. على الرغم من عدم الموصى به، يمكنك العودة إلى الإصدار 3 عن طريق تعيين متغير USEV3_FOR_PYTHON38 البيئة إلى true.
يتم إهمال أوقات التشغيل التالية في Azure Static Web Apps. لمزيد من المعلومات حول تغيير وقت التشغيل، راجع تحديد إصدار وقت تشغيل لغة واجهة برمجة التطبيقات في Azure Static Web Appsوترحيل التطبيقات من الإصدار 3.x من Azure Functions إلى الإصدار 4.x.
- .NET Core 3.1
- Node.js 12.x