التشغيل السريع: إضافة إشارات الميزة إلى تطبيقNET Framework

في هذا التشغيل السريع، يمكنك دمج تكوين تطبيق Azure في تطبيق .NET Framework لإنشاء تطبيق شامل لإدارة الميزات. يمكنك استخدام خدمة تكوين التطبيق لتخزين كافة إشارات الميزات، والتحكم في حالاتها مركزياً.

مكتبات إدارة ميزات .NET توسع إطار العمل مع دعم إشارة الميزة. تُنشأ هذه المكتبات فوق نظام تكوين .NET. وهم يتكاملوا مع تكوين التطبيق من خلال موفر تكوين .NET الخاص بها.

المتطلبات الأساسية

إنشاء متجر تكوين التطبيقات

  1. لإنشاء متجر جديد لـ App Configuration قم بتسجيل الدخول إلى مدخل Azure.

  2. في الجانب العلوي الأيسر من الصفحة، اختر "إنشاء مورد" .

  3. في مربع خدمات البحث والسوق، أدخل App Configuration، وحدد Enter.

    لقطة شاشة تعرض صفحة البحث عن تكوين التطبيق.

  4. حدد "App Configuration" من نتائج البحث، ثم حدد "إنشاء" .

    لقطة شاشة تعرض صفحة الإنشاء.

  5. في جزء "Create App Configuration"، أدخل الإعدادات التالية:

    الإعداد القيمة المقترحة الوصف
    الاشتراك اشتراكك اختر اشتراك Azure الذي ترغب في استخدامه لتجربة App Configuration. إذا كان حسابك يحتوي على اشتراك واحد فقط فيتم اختياره تلقائياً، ولا تظهر قائمة الاشتراك المنسدلة.
    مجموعة الموارد AppConfigTestResources يوصى باختيار أو إنشاء مجموعة موارد لمورد متجر App Configuration. تعد مجموعة فعالة في تنظيم موارد متعددة قد ترغب في حذفها في ذات الوقت بحذف مجموعة الموارد. للمزيد من المعلومات، يُرجى الرجوع إلى استخدام مجموعات الموارد لإدارة موارد Azure.
    اسم المورد اسم فريد عالمياً أدخل اسم مورد مميزاً لاستخدامه في مورد متجر App Configuration. يجب أن يكون الاسم مكون من 5 إلى 50 حرفاً ويتضمن أرقام وحروف ورموز فقط -. لا يمكن بدء الاسم أو إنهاءه - برمز.
    الموقع وسط الولايات المتحدة يوصى بتفعيل الموقع لتحديد الموقع الجغرافي الذي يتم فيه استضافة مورد app configuration. للحصول على أفضل أداء، نوصي بإنشاء المورد في المنطقة ذاتها مثل المكونات الأخرى للتطبيق الخاص بك.
    ⁩مستوى التسعير⁧ مجاني حدد مستوى التسعير المطلوب. لمزيد من المعلومات، راجع صفحة تسعير App Configuration.
  6. حدد "مراجعة + إنشاء" للتحقق من صحة الإعدادات.

  7. حدد Create. قد يستغرق انتهاء الإعداد بضع دقائق.

  8. بعد انتهاء التوزيع، انتقل إلى مورد تكوين التطبيق. حدد مفاتيح الوصول>إلى الإعدادات. يرجى ملاحظة أن جهة اتصال المفتاح الأساسي للقراءة فقط. ستستخدم جهة الاتصال هذه لاحقا لتكوين التطبيق للاتصال بمتجر App Configuration الذي أنشأته.

  1. اختر⁧⁩Feature Manager⁧⁩⁧>⁩⁧⁩Add+⁧⁩ لإضافة إشارة ميزة تُسمى ⁧Beta⁩.

    تفعيل علامة الميزة المسماة Beta

    اترك⁧label⁩ غير المُعرَّف حالياً.

إنشاء تطبيق NET console

  1. ابدأ Visual Studio، وحدد ⁧⁩ملف⁧⁩⁧>⁩⁧⁩مشروع⁧⁩⁧>⁩⁧⁩جديد⁧⁩.

  2. من ⁧⁩إنشاء مشروع جديد،⁧⁩ تصفية⁧⁩نوع مشروع وحدة التحكم⁧⁩واختر⁧⁩Console App (.NET Framework)⁧⁩. انقر فوق التالي.

  3. من⁧⁩تكوين مشروعك الجديد،⁧⁩أدخل اسم المشروع. من أسفل⁧⁩إطار العمل⁧⁩اختر⁧⁩4.8 NET Framework ⁧⁩ أو أعلى من ذلك. انقر فوق Create.

اتصل بمتجر تكوين التطبيقات

  1. انقر بزر الماوس الأيمن فوق مشروعك، واختر⁧⁩إدارة حزم NuGet⁧⁩. في علامة تبويب ⁧⁩استعراض⁧⁩ابحث وأضف حزم NuGet التالية إلى مشروعك.

    Microsoft.Extensions.DependencyInjection
    Microsoft.Extensions.Configuration.AzureAppConfiguration
    Microsoft.FeatureManagement
    
  2. افتح ⁧⁩Program.cs⁧⁩، وأضف العبارات التالية:

    using Microsoft.Extensions.DependencyInjection;
    using Microsoft.Extensions.Configuration;
    using Microsoft.Extensions.Configuration.AzureAppConfiguration;
    using Microsoft.FeatureManagement;
    using System.Threading.Tasks;
    
  3. تحديث⁧Main⁩أسلوب الاتصال بتكوين التطبيق، وحدد⁧UseFeatureFlags⁩الخيار بحيث تُستَرَد إشارات الميزة. ثم اعرض الرسالة إذا⁧Beta⁩ مُكِنَّت إشارة الميزة.

        public static async Task Main(string[] args)
        {         
            IConfigurationRoot configuration = new ConfigurationBuilder()
                .AddAzureAppConfiguration(options =>
                {
                    options.Connect(Environment.GetEnvironmentVariable("ConnectionString"))
                           .UseFeatureFlags();
                }).Build();
    
            IServiceCollection services = new ServiceCollection();
    
            services.AddSingleton<IConfiguration>(configuration).AddFeatureManagement();
    
            using (ServiceProvider serviceProvider = services.BuildServiceProvider())
            {
                IFeatureManager featureManager = serviceProvider.GetRequiredService<IFeatureManager>();
    
                if (await featureManager.IsEnabledAsync("Beta"))
                {
                    Console.WriteLine("Welcome to the beta!");
                }
            }
    
            Console.WriteLine("Hello World!");
            Console.WriteLine("Press any key to continue ...");
            Console.Read();
        }
    

إنشاء التطبيق وتشغيله محلياً

  1. تعيين environment variable الذي يسمى ⁧⁩ConnectionString⁧⁩، وتعيينه إلى سلسلة الاتصال بمتجر تكوين التطبيق. إذا كنت تستخدم مطالبة أوامر Windows، فقم بتشغيل الأمر التالي:

        setx ConnectionString "connection-string-of-your-app-configuration-store"
    

    إذا كنت تستخدم Windows PowerShell، فشَغِّل الأمر التالي:

        $Env:ConnectionString = "connection-string-of-your-app-configuration-store"
    
  2. أعد تشغيل Visual Studio للسماح بتغييرات حيز التنفيذ.

  3. اضغط على Ctrl + F5 لإنشاء تطبيق وحدة التحكم وتشغيله.

    التطبيق مع تمكين إشارة الميزة

تنظيف الموارد

إذا كنت لا تريد مواصلة استخدام الموارد التي تم إنشاؤها في هذه المقالة، يوصى بحذف مجموعة الموارد التي أنشأتها هنا لتجنب الرسوم.

هام

حذف مجموعة الموارد لا يمكن التراجع عنه. يتم حذف مجموعة الموارد وجميع الموارد المضمنة فيها نهائياً. تأكد من عدم حذفك للموارد أو مجموعة المورد الخاطئة عن غير قصد. في حالة إنشاء الموارد لهذه المقالة داخل مجموعة موارد تشتمل على موارد أخرى تريد الاحتفاظ بها، احذف كل مورد على حدة من الجزء الخاص به بدلاً من حذف مجموعة الموارد.

  1. سجل الدخول إلى⁧⁩مدخل Microsoft Azure⁧⁩، وحدد⁧⁩مجموعات الموارد⁧⁩.
  2. في المربع ⁧⁩تصفية حسب الاسم⁩، اكتب اسم مجموعة الموارد.
  3. في قائمة النتائج، حدد اسم مجموعة الموارد لاستعراض نظرة عامة.
  4. حدد Delete resource group.
  5. يُطلب منك تأكيد حذف مجموعة الموارد. أدرج اسم مجموعة الموارد لتأكيده، واختر ⁧⁩حذف⁧⁩.

بعد بضع لحظات، يتم حذف مجموعة الموارد وكافة مواردها.

الخطوات التالية

عند بداية التشغيل، إنك أنشأت علامة ميزة في تكوين التطبيق، واستخدمتها مع تطبيق وحدة تحكم .NET Framework. لمعرفة كيفية تحديث إشارات الميزة وقيم التكوين الأخرى بدون إعادة تشغيل التطبيق، أكمل البرنامج التعليمي التالي.