https://thedotnetblog.com/ar/tags/wpf/Articles, tutorials and insights from the .NET community.Hugoar@thedotnetblog (The .NET Blog)@thedotnetblogThu, 23 Apr 2026 00:00:00 +0000https://thedotnetblog.com/ar/posts/emiliano-montesdeoca/windows-app-dev-cli-v03-run-ui-automation/Thu, 23 Apr 2026 00:00:00 +0000Emiliano Montesdeocahttps://thedotnetblog.com/ar/posts/emiliano-montesdeoca/windows-app-dev-cli-v03-run-ui-automation/يُقدّم Windows App Development CLI v0.3 أمر winapp run لتشغيل التطبيقات وتنقيحها من الطرفية، وأمر winapp ui لأتمتة الواجهة، وحزمة NuGet جديدة تتيح dotnet run مع التطبيقات المُحزَّمة.<p><em>تمت ترجمة هذا المنشور تلقائيًا. للاطلاع على النص الأصلي، <a href="https://thedotnetblog.com/ar/posts/emiliano-montesdeoca/windows-app-dev-cli-v03-run-ui-automation/">انقر هنا</a>.</em></p> <p>تجربة F5 في Visual Studio رائعة. لكن فتح VS لمجرد تشغيل تطبيق Windows مُحزَّم وتنقيحه — سواء في خط أنابيب CI، أو سير عمل آلي، أو عندما يُجري وكيل ذكاء اصطناعي الاختبارات — يُشكّل عبئًا زائدًا.</p> <p>صدر الإصدار v0.3 من Windows App Development CLI <a href="https://devblogs.microsoft.com/ifdef-windows/windows-app-development-cli-v0-3-new-run-and-ui-commands-plus-dotnet-run-support-for-packaged-apps/">للتو</a>، ويعالج هذا الأمر مباشرةً بميزتين رئيسيتين: <code>winapp run</code> و<code>winapp ui</code>.</p> <h2 id="winapp-run-f5-من-أي-مكان">winapp run: F5 من أي مكان</h2> <p>يستقبل <code>winapp run</code> مجلد تطبيق غير مُحزَّم وملف manifest، وينفّذ كل ما يفعله VS عند تشغيل التنقيح: تسجيل حزمة loose، وتشغيل التطبيق، والحفاظ على <code>LocalState</code> بين عمليات إعادة النشر.</p> <div class="highlight"><pre tabindex="0" class="chroma"><code class="language-bash" data-lang="bash"><span class="line"><span class="cl"><span class="c1"># قم ببناء التطبيق، ثم شغّله كتطبيق مُحزَّم</span> </span></span><span class="line"><span class="cl">winapp run ./bin/Debug </span></span></code></pre></div><p>يعمل مع WinUI وWPF وWinForms وConsole وAvalonia والمزيد. صُمِّمت الأوضاع للمطورين وسير العمل الآلي على حد سواء:</p> <ul> <li><strong><code>--detach</code></strong>: يُشغَّل التطبيق ويُعاد التحكم فورًا إلى الطرفية. مثالي لـ CI.</li> <li><strong><code>--unregister-on-exit</code></strong>: يُزيل الحزمة المُسجَّلة عند إغلاق التطبيق.</li> <li><strong><code>--debug-output</code></strong>: يلتقط رسائل <code>OutputDebugString</code> والاستثناءات في الوقت الفعلي.</li> </ul> <h2 id="حزمة-nuget-جديدة-dotnet-run-للتطبيقات-المحزمة">حزمة NuGet جديدة: dotnet run للتطبيقات المُحزَّمة</h2> <p>يتوفر للمطورين العاملين بـ .NET حزمة NuGet جديدة: <code>Microsoft.Windows.SDK.BuildTools.WinApp</code>. بعد التثبيت، يتولى <code>dotnet run</code> إدارة الحلقة الداخلية بأكملها: البناء، وتحضير حزمة loose-layout، والتسجيل في Windows، والتشغيل — كل ذلك في خطوة واحدة.</p> <div class="highlight"><pre tabindex="0" class="chroma"><code class="language-bash" data-lang="bash"><span class="line"><span class="cl">winapp init </span></span><span class="line"><span class="cl"><span class="c1"># أو</span> </span></span><span class="line"><span class="cl">dotnet add package Microsoft.Windows.SDK.BuildTools.WinApp </span></span></code></pre></div><h2 id="winapp-ui-أتمتة-واجهة-المستخدم-من-سطر-الأوامر">winapp ui: أتمتة واجهة المستخدم من سطر الأوامر</h2> <p>هذه هي الميزة التي تفتح سيناريوهات الوكلاء الذكيين. يوفر <code>winapp ui</code> وصولًا كاملًا عبر UI Automation لأي تطبيق Windows قيد التشغيل — WPF وWinForms وWin32 وElectron وWinUI3 — مباشرةً من الطرفية.</p> <p>ما يمكن تحقيقه:</p> <ul> <li>سرد جميع النوافذ على المستوى الأعلى</li> <li>التنقل في شجرة UI Automation الكاملة لأي نافذة</li> <li>البحث عن عناصر بالاسم أو النوع أو معرّف الأتمتة</li> <li>النقر والاستدعاء وتعيين القيم</li> <li>التقاط لقطات الشاشة</li> <li>انتظار ظهور العناصر — مثالي لمزامنة الاختبارات</li> </ul> <p>يُتيح الجمع بين <code>winapp ui</code> و<code>winapp run</code> سير عملًا كاملًا من الطرفية: بناء ← تشغيل ← تحقق. يمكن للوكيل تشغيل التطبيق، وفحص حالة الواجهة، والتفاعل برمجيًا، والتحقق من النتيجة.</p> <h2 id="مستجدات-أخرى">مستجدات أخرى</h2> <ul> <li><strong><code>winapp unregister</code></strong>: يحذف حزمة sideloaded عند الانتهاء.</li> <li><strong><code>winapp manifest add-alias</code></strong>: يُضيف اسمًا مستعارًا لتشغيل التطبيق بالاسم من الطرفية.</li> <li><strong>إكمال تلقائي بـ Tab</strong>: تهيئة إكمال PowerShell بأمر واحد.</li> </ul> <h2 id="كيفية-التثبيت">كيفية التثبيت</h2> <div class="highlight"><pre tabindex="0" class="chroma"><code class="language-bash" data-lang="bash"><span class="line"><span class="cl">winget install Microsoft.WinAppCli </span></span><span class="line"><span class="cl"><span class="c1"># أو</span> </span></span><span class="line"><span class="cl">npm install -g @microsoft/winappcli </span></span></code></pre></div><p>الأداة في معاينة عامة. راجع <a href="https://github.com/microsoft/WinAppCli">مستودع GitHub</a> للتوثيق الكامل، و<a href="https://devblogs.microsoft.com/ifdef-windows/windows-app-development-cli-v0-3-new-run-and-ui-commands-plus-dotnet-run-support-for-packaged-apps/">الإعلان الأصلي</a> لجميع التفاصيل.</p>