إنشَاء حزمة حَل لمكون التعليمَات البرمجية
يجب عليك نشر مكون التعليمَات البرمجية فِي Microsoft Dataverse بيئة مَا قبل استخدَامه فِي Power Apps أو Power Pages. وظيفتك الأولى لنشر أحد المكونَات هي تجميع مكون التعليمَات البرمجية الخَاص بك فِي حل، ممَا يسمح لك باستيرَاده إلى بيئة مَا. يمكنك تحقيق ذلك بطريقتين. يمكنك استخدَام أمر CLI Push لإنشَاء حَل مؤقت لدفع المكون الخَاص بك إلى بيئة لتسهيل الاختبار. يعد هَذَا الأسلوب رَائعًا للاستخدَام أثنَاء تطوير المكون. الخيَار الآخر هو إنشَاء حَل للمكون واستيرَاده بشكل مِنفصل إلى Dataverse بيئتك. يعد هَذَا الخيَار مفِيدًا للاستخدَام فِي مسَارَات الإنشَاء أو النشر اليدوي فِي بيئة أخرى غير بيئة التطوير الخَاصة بك. هيَا نستكشف كلا الخيَارين بمزيد مِن التفَاصيل.
فِي الخطوَات التَالِية، ستتدرب عَلى كلا الأسلوبين باستِخدَام مكون التعليمَات البرمجية الذي قمت بإنشَائه فِي الموضوع الأخير أو أحد نَمَاذِج المكونَات المتَاحة.
المتطلبات الأسَاسِية
يجب أن يكون لديك مشروع مكون تعليمَات برمجية موجود تم إنشَاؤه بالفعل. يمكنك اتباع هذه الخطوات لأي مشروع آخر لمكونَات التعليمَات البرمجية، مِثلَ عينة المكونَات.
دفع مكون إلى بيئة Dataverse أثنَاء التطوير
لدفع مكون تعليمَات برمجية باستِخدَام Power Platform CLI، اتبع هذه الخطوات:
ابدَأ تشغيل Visual Studio Code وحدد المستكشف.
حدد فتح المجلد.
حدد مجلد المشروع القَابل editable-pcf الذي قمت بإنشَائه فِي التَمرين المعملي السَابق وحدد تحديد مجلد.
حدد علامة التبويب Power Platform، ثمَّ حدد إضَافَة مِلَف تعريف مصَادقة.
ابحث عَن نَافذة تسجيل الدخول إلى حسَابك وحدد الحسَاب الذي ترغب فِي استخدَامه. أدخل اسم المستخدم المِنَاسب، وحدد "التَالِي"، وأدخل كلمة المرور. قد تحتاج إلى توفِير MFA إذَا تم إعدَاده فِي المستأجر الخَاص بك.
سيظهر ملف التعريف الذي أضفته ضمِن ملفات تعريف المصادقة، إلى جَانب البيئات والحلول المرتبطة. تأكد مِن تحديد البيئة المِنَاسبة ضمِن البيئة والحلول. سيكون هنَاك نجمة يمكنك اختيَارهَا. تأكد مِن تمكين Component Framework فِي البيئة المحددة أيضًا فِي قسم ميزَات البيئة فِي مَركَز مسؤولي Power Platform للبيئة المحددة.
حدد Terminal ثم حدد New Terminal.
قم ببنَاء المشروع عَن طريق تشغيل الأمر أدنَاه والتأكد مِن أنه تم إنشَاؤه بنجَاح.
npm run build
ادفع عنصر التحكم المخصص إلى بيئتك عَن طريق تشغيل الأمر أدنَاه.
pac pcf push --publisher-prefix msl
لاحظ فِي الصورة المربع الأحمر الذي يشير إلى قسمي "متصل كـ" و"متصل بـ". تأكد مِن تطَابقهَا معَ "مِلَف تعريف المصَادقة" و"البيئة" المحددة مِن خطواتك السَابقة.
يجب أن يتم استيرَاد الحَل إلى بيئتك ونشره.
يمكنك تجَاهل رسَالة التحذير الصفرَاء فِي حَالة استلامهَا.
انتقِل إلى Power Apps maker portal وتأكد مِن وجودك فِي البيئة الصحيحة.
حدد الحلول.
مِن المفترض أن ترى الحَل PowerAppsTools_msl. حدد لفتح الحل.
مِن المفترض أن ترى عنصر التحكم المخصص الذي أنشأته.
إنشَاء مِلَف حَل باستِخدَام Power Platform CLI
لإنشَاء مِلَف حَل باستِخدَام Power Platform CLI، اتبع الخطوَات التَالِية:
ارجع إلى Visual Studio Code وتأكد مِن أن مشروع EDITABLE-PCF مفتوح.
انتقِل إلى المحطة وإلى موجه الأوامر.
قم بإنشَاء مجلد جَدِيد عَن طريق تشغيل الأمر أدنَاه.
md Solutionقم بتغيير الدليل إلى مجلد الحَل الذي قمت بإنشَائه. قم بتشغيل الأمر أدنَاه.
cd Solutionتهيئة مشروع حَل فِي Dataverse باستِخدَام الأمر التَالِي:
pac solution init --publisher-name mslearn --publisher-prefix mslأبلغ مشروع الحَل الخَاص بك أنه سيتم إضَافَة مكونَاته أثنَاء الإنشَاء. لإنجَاز هذه المهمة، استخدم الأمر التَالِي:
pac solution add-reference --path ..لإنشَاء ملف مضغوط للحل الخَاص بك، استخدم Microsoft Build Engine، أو msbuild للاختصار. ستحتاج فقط إلى استخدَام علامة /الاستعادة فِي المرة الأولى التي يتم فِيهَا بنَاء مشروع الحل. فِي كل بنية لاحقة، ستحتَاج إلى تشغيل msbuild فقط. بإمكان المسَار إلى MSBuild.exe أن يكون مختلفًا بحسب إصدَار Visual Studio المثبت عَلى جِهَازك.
"C:\Program Files (x86)\Microsoft Visual Studio\2022\BuildTools\MSBuild\Current\Bin\MSBuild.exe\" /t:build /restoreمِن المفترض أن تنجح عملية البنَاء.
حدد موقع مجلد الحل الذي أنشأته، وقم بتوسيعه.
قم بتوسيع المجلد bin\debug.
يجب أن تشَاهد مِلَف Solution.zip هنَا.
ملاحظة
لتشغيل MSBuild، تحتَاج إلى تثبيت أدوات بنَاء Visual Studio أو Visual Studio. يمكنك تثبيت أدوات البنَاء مِن تنزيلات Visual Studio. للوُصُول إلى MSBuild، قد تحتَاج إلى إضَافته إلى دليل مسَار متغيرَات بيئة Windows. عَلى سَبِيل المثَال، يقوم Visual Studio 2022 بتخزين MSBuild فِي C:\Program Files (x86)\Microsoft Visual Studio\2022\Enterprise\MSBuild\Current\Bin. يمكنك أيضًا استخدَام موجه أوامر المطور فِي Visual Studio للوصول إلى MSBuild، أو تشغيله باستِخدَام المسَار الكامل المؤهل ("C:\ملفات البرَامج (x86)\Microsoft Visual Studio\2022\المؤسسَات\MSBuild\الحالي\الحاوية\MSBuild.exe"/t:إنشَاء /استعادة).
نَوع الحزمة الافترَاضي هو حَل مُدَار. إذَا أردت تصديره باعتباره غير مُدَار (أو كلاهمَا)، فِيمكنك مسح (أو إلغاء تحديد) التعليق الموجود فِي القسم التَالِي مِن Solutions.cdsproj وتحرير عقدة SolutionPackageType وفقًا لذلك:
<!-- Solution Packager overrides un-comment to use: SolutionPackagerType Managed, Unmanaged, Both)-->
<PropertyGroup>
<SolutionPackageType>Unmanaged</SolutionPackageType>
</PropertyGroup>
يمكنك تعيين تَكوِين msbuild إلى الإصدَار لإصدَار بنية الإنتَاج، عَلى سَبِيل المِثَال، msbuild /p:configuration=Release.
يمكنك استيرَاد المِلَف المضغوط الذي يحتوي عَلى مِلَف موجود يدويَا فِي bin\Debug أو bin\Release، وذلك وفقًا لتَكوِين الإصدَار. يمكنك أيضًا نشر مكونَات التعليمَات البرمجية الخَاصة بك برمجيَا باستِخدَام Power Platform CLI. لمَزيدٍ مِن المَعلومَات، رَاجِع الاتصَال بالبيئة الخَاصة بك وأيضًا نشر مكونَات التعليمَات البرمجية وهي عبارة عَن أقسَام حزم وثَائق مكون التعليمَات البرمجية.