التشغيل السريع: إضافة علامات الميزات إلى تطبيق وحدة تحكم .NET/.NET Framework

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

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

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

• حساب Azure مع اشتراك نشط. أنشئ حسابًا مجانًا.
• متجر App Configuration. إنشاء متجر.
• Visual Studio
• .NET SDK 6.0 أو أحدث لتطبيق وحدة تحكم .NET.
• .NET Framework 4.7.2 أو أحدث لتطبيق وحدة تحكم .NET Framework.

إضافة علامة ميزة

أضف علامة ميزة تسمى Beta إلى متجر App Configuration واترك Label and Description بقيمها الافتراضية. لمزيد من المعلومات حول كيفية إضافة علامات الميزات إلى متجر باستخدام مدخل Microsoft Azure أو CLI، انتقل إلى إنشاء علامة ميزة.

إنشاء تطبيق وحدة التحكم

يمكنك استخدام Visual Studio لإنشاء مشروع تطبيق وحدة تحكم جديد.

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

2. في إنشاء مشروع جديد، قم بالتصفية على نوع مشروع وحدة التحكم وحدد تطبيق وحدة التحكم. إذا كنت ترغب في إنشاء تطبيق .NET Framework، فيرجى تحديد تطبيق وحدة التحكم (.NET Framework) بدلا من ذلك. انقر فوق التالي.

3. في تكوين المشروع الجديد،أدخل اسم المشروع. إذا كنت تقوم بإنشاء تطبيق .NET Framework، فيرجى تحديد .NET Framework 4.7.2 أو أعلى ضمن Framework. انقر فوق Create.

استخدام علامة الميزة

1. حدد بزر الماوس الأيمن على المشروع، وحدد Manage NuGet Packages. في علامة التبويب استعراض ، ابحث عن حزم NuGet التالية وأضفها إلى مشروعك.

   Microsoft.Extensions.Configuration.AzureAppConfiguration
   Microsoft.FeatureManagement
   

   تأكد من أن إصدار أكبر من Microsoft.FeatureManagement 3.1.0.

2. افتح Program.cs وأضف العبارات التالية.

   using Microsoft.Extensions.Configuration;
   using Microsoft.Extensions.Configuration.AzureAppConfiguration;
   using Microsoft.FeatureManagement;
   

3. الاتصال إلى App Configuration، مع UseFeatureFlags تحديد الخيار بحيث يتم استرداد علامات الميزة. ConfigurationFeatureDefinitionProvider إنشاء لتوفير تعريف علامة الميزة من التكوين و FeatureManager لتقييم حالة علامات الميزة. ثم اعرض رسالة إذا تم تمكين علامة الميزة Beta .

   NET.

   IConfiguration configuration = new ConfigurationBuilder()
       .AddAzureAppConfiguration(options =>
       {
           options.Connect(Environment.GetEnvironmentVariable("ConnectionString"))
               .UseFeatureFlags();
       }).Build();
   
   IFeatureDefinitionProvider featureDefinitionProvider = new ConfigurationFeatureDefinitionProvider(configuration);
   
   IFeatureManager featureManager = new FeatureManager(
       featureDefinitionProvider, 
       new FeatureManagementOptions());
   
   if (await featureManager.IsEnabledAsync("Beta"))
   {
       Console.WriteLine("Welcome to the beta!");
   }
   
   Console.WriteLine("Hello World!");
   

   .NET Framework

   public static async Task Main(string[] args)
   {         
       IConfiguration configuration = new ConfigurationBuilder()
           .AddAzureAppConfiguration(options =>
           {
               options.Connect(Environment.GetEnvironmentVariable("ConnectionString"))
                   .UseFeatureFlags();
           }).Build();
   
       IFeatureDefinitionProvider featureDefinitionProvider = new ConfigurationFeatureDefinitionProvider(configuration);
   
       IFeatureManager featureManager = new FeatureManager(
           featureDefinitionProvider, 
           new FeatureManagementOptions());
   
       if (await featureManager.IsEnabledAsync("Beta"))
       {
           Console.WriteLine("Welcome to the beta!");
       }
   
       Console.WriteLine("Hello World!");
   }
   

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

1. قم بتعيين متغير بيئة يسمى الاتصال ionString إلى سلسلة الاتصال لمتجر App Configuration.

   واجهة أوامر Windows

   إذا كنت تستخدم موجه أوامر 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 لإنشاء التطبيق وتشغيله.

4. يجب أن تشاهد المخرجات التالية في وحدة التحكم.

   

5. قم بتسجيل الدخول إلى بوابة Azure. حدد All resources، وحدد App Configuration store الذي قمت بإنشائه مسبقا.

6. حدد إدارة الميزات وحدد موقع علامة ميزة Beta . قم بتمكين العلامة عن طريق تحديد خانة الاختيار ضمن ممكن.

7. شغّل التطبيق مرة أخرى. يجب أن تشاهد رسالة Beta في وحدة التحكم.

   

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

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

هام

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

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

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

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

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

تمكين التكوين الديناميكي في تطبيق .NET

تمكين التكوين الديناميكي في تطبيق .NET Framework