الإرشادات التفصيلية: نشر تطبيقات ClickOnce يدوياً

مقالة
07/23/2010

إذا كان لا يمكنك استخدام ‏‫Visual Studio لنشر الخاص بك ClickOnceتطبيق، أو كنت بحاجة إلى استخدام ميزات النشر المتقدمة، مثل كـ الموثوقة نشر تطبيقات، يجب عليك استخدام أداة سطر الأوامر Mage.exe لإنشاء الخاص بك ClickOnceبيانات. تصف هذه معاينة كيفية إنشاء ClickOnceتوزيع باستخدام إصدار سطر أوامر (Mage.exe) أو إصدار رسومية (MageUI.exe) بيان إنشاء وتحرير أداة.

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

لدى هذه معاينة لبعض المتطلبات الأساسية والخيارات التي تحتاج إلى اختيار قبل إنشاء توزيع.

قم بتثبيت Mage.exe و MageUI.exe.

Mage.exe و MageUI.exe جزء من عدة تطوير برامج Windows (SDK). يجب أن يكون لديك أما Windows SDKتثبيت أو الإصدار Windows SDKالمضمنة مع ‏‫Visual Studio. لمزيد من معلومات، راجع من ‏‫Windows SDK في MSDN.
توفير تطبيق إلى نشرها.

تفترض هذه معاينة بوجود أحد تطبيقات Windows جاهزك إلى نشرها. سوف تكون الإشارة هذا تطبيق إلى كـ AppToDeploy.
تحديد كيفية توزيع النشر.

تضمين خيارات التوزيع: صفحة ويب أو يجعله مشتركًا ملف أو CD. لمزيد من المعلومات، راجع أمان ClickOnce والتوزيع.
تحديد ما إذا كان يتطلب تطبيق امتيازات المسؤول المستوى الثقة.

إذا كان تطبيق الخاص بك تتطلب "الثقة تامة" — كاملة على سبيل المثال، للوصول إلى استخدم نظام r's — يمكنك استخدم -TrustLevelبتعيين هذا خيار Mage.exe. إذا أردت تعريف أحد أذونات مخصصة للتطبيق الخاص بك، يمكنك نسخ مقطع أذونات إنترنت أو إنترانت من بيان آخر أو تعديله ليناسب احتياجاتك، و إضافة إلى بيان تطبيق باستخدام محرر نص أو MageUI.exe. لمزيد من المعلومات، راجع نظرة عامة على نشر التطبيق موثوق به.
الحصول على شهادة المصادقة.

يجب أن تقوم بتسجيل عملية توزيع مع شهادة المصادقة. يمكنك توليد شهادة اختبار بواسطة استخدام أدوات ‏‫Visual Studio، MageUI.exe، أو MakeCert.exe و Pvk2Pfx.exe، أو يمكن الحصول على شهادة من مرجع الشهادات (CA). إذا قمت باختيار إلى استخدام "نشر تطبيقات الموثوق بها"، يجب أيضا إجراء تثبيت مرة واحدة فقط من الشهادة على إلى الجميع أجهزة الكمبيوتر العميلة. لمزيد من المعلومات، راجع نظرة عامة على نشر التطبيق موثوق به.
تأكد من أن تطبيق لا يحتوي معلومات مع UAC بيان.

تحتاج إلى تحديد ما إذا كان تطبيق الخاص بك يحتوي على بيان مع مستخدم معلومات الحساب التحكم (UAC)، مثل عنصر <dependentAssembly>العنصر. إلى تفحص ملف بيان تطبيق، يمكنك استخدام Windows Sysinternals Sigcheck المساعدة.

إذا كان تطبيق الخاص بك يحتوي على تفاصيل مع UAC بيان، يجب أن re-بنية مع مسح المعلومات UAC. C# مشروع في ‏‫Visual Studio، افتح خصائص المشروع ثم قم بتحديد تطبيق علامة تبويب. في القائمة البيان المنسدلة، تحديد إنشاء تطبيق بدون بيان. لمشروع Visual أساسى في ‏‫Visual Studio، افتح خصائص مشروع، تحديد تطبيق علامة الجدولة، ثم انقر فوق عرض إعدادات UAC. في فتحها البيان ملف، قم بإزالة الجميع العناصر الموجودة واحدة <asmv1:assembly>العنصر.
تحديد ما إذا كان يتطلب تطبيق المتطلبات الأساسية تشغيل الكمبيوتر العميل.

ClickOnceيمكن أن تضمين التطبيقات التي تم نشرها من برنامج ‏‫Visual Studio الإطلاق المتطلبات الأساسية لتثبيت (setup.exe) مع توزيع الخاصة بك. هذه معاينة بإنشاء بيانات الثاني المطلوبة ClickOnceتوزيع. يمكنك إنشاء الإطلاق المتطلبات الأساسية باستخدام المهام GenerateBootstrapper.

إلى نشر أحد تطبيقات باستخدام Mage.exe سطر الأوامر إلى ol

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

ملاحظة

يمكن أن يكون الإصدار توزيع مختلفة عن الإصدار تطبيق الخاص بك.
قم بنسخ الجميع ملفات تطبيق الخاص بك إلى الدليل الفرعي الإصدار، بما في ذلك الملفات القابلة للتنفيذ، والتجميعات، والموارد، و ملفات بيانات. وعند الضرورة، يمكنك إنشاء الدلائل الفرعية الإضافية التي تحتوي على ملفات إضافى.
قم بفتح Windows SDKأو تعجيل الأوامر ‏‫Visual Studio والتغيير إلى الدليل الفرعي الإصدار.
إنشاء بيان تطبيق باستدعاء إلى Mage.exe. ينشئ العبارة التالية لتطبيق كشف للتعليمات البرمجية التي تم تحويلها برمجياً ليعمل تشغيل المعالج Intel x86.
```
mage -New Application -Processor x86 -ToFile AppToDeploy.exe.manifest -name "My App" -Version 1.0.0.0 -FromDirectory . 
```
ملاحظة

تأكد من تضمين النقطة (.) بعد -FromDirectoryخيار، الذي يشير إلى الدليل الحالي. في حالة عدم تضمين كانت النقطة، يجب تحديد مسار إلى ملفات تطبيق الخاص بك.
قم بتسجيل الملف الظاهر للتطبيق مع شهادة المصادقة الخاصة بك. قم باستبدال mycert.pfx بمسار الشهادة الخاص بك ملف. قم باستبدال passwd بكلمة مرور لملف الشهادة.
```
mage -Sign AppToDeploy.exe.manifest -CertFile mycert.pfx -Password passwd
```
تغيير إلى جذر الدليل توزيع.
قم بإنشاء عملية نشر بيان باستدعاء Mage.exe. بشكل افتراضي، سيتم وضع علامة Mage.exe الخاص بك ClickOnceنشر كـ تثبيت تطبيق ما، حتى أنه يمكن تشغيل كل من إنترنت ودون اتصال. لجعل تطبيق متوفراً فقط عند مستخدم هو متصل، استخدم -Installخيار القيمة false. إذا كنت تستخدم الإعداد الافتراضي، والمستخدمين بتثبيت تطبيق الخاص بك من الموقع ويب أو ملف مشترك، تأكد من أن الالقيمة -ProviderUrlخيار يشير إلى الموقع تطبيق بيان تشغيل الخادم ويب أو يجعله مشتركًا.
```
mage -New Deployment -Processor x86 -Install true -Publisher "My Co." -ProviderUrl "\\myServer\myShare\AppToDeploy.application" -AppManifest 1.0.0.0\AppToDeploy.exe.manifest -ToFile AppToDeploy.application
```
تسجيل النشر بيان بشهادة المصادقة الخاصة بك.
```
mage -Sign AppToDeploy.application -CertFile mycert.pfx -Password passwd
```
قم بنسخ الجميع الملفات الموجودة في الدليل توزيع إلى وجهة توزيع أو وسائط. قد يكون ذلك في أي مجلد موجود تشغيل موقع ويب أو موقع FTP أو يجعله مشتركًا ملف أو CD.
تزويد المستخدمين بعنوان URL أو UNC أو الوسيطة الفعلية المطلوب إلى يثّبت تطبيق الخاص بك. إذا قمت بتوفير عنوان URL أو UNC، فيجب منح المستخدمين مسار الكامل للنشر بيان. على سبيل المثال، إذا كان AppToDeploy هو نشرة إلى http://webserver01/في الدليل AppToDeploy، المسار محدد موقع المعلومات الكامل سيكون http://webserver01/AppToDeploy/AppToDeploy.تطبيق.

إلى نشر أحد تطبيقات باستخدام MageUI.exe الرسومية إلى ol

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

ملاحظة

الإصدار توزيع هو dهوtinct من المحتمل أن يكون من الإصدار تطبيق الخاص بك.
قم بنسخ الجميع ملفات تطبيق الخاص بك إلى الدليل الفرعي الإصدار، بما في ذلك الملفات القابلة للتنفيذ، والتجميعات، والموارد، و ملفات بيانات. وعند الضرورة، يمكنك إنشاء الدلائل الفرعية الإضافية التي تحتوي على ملفات إضافى.
يبدأ أداة رسومية MageUI.exe.
```
MageUI.exe
```
إنشاء جديد بيان تطبيق بتحديد ملف جديد ، بيان تطبيق من قائمة.
تشغيل علامة الافتراضي التبويب اسم، نوع اسم ورقم الإصدار هذا توزيع. المعالج أيضا بتحديد التي تطبيق الخاص بك هو المضمنة، مثل x86.
تحديد علامة تبويب ملفات ثم انقر فوق butإلىn علامة القطع ( ... ) ثم إلى صندوق نص direcإلىry تطبيق. "استعراض خاص بالمجلدات" صندوق حوار تظهر.
دليل فرعي للإصدار الذي يحتوي على ملفات تطبيق الخاص بك، تحديد و ثم انقر فوق ‏‏موافق .
إذا كان سيتم نشر من الخدمات معلومات الإنترنت (IIS)، تحديد عند ملء إضافة ملحق.deploy إلى أي ملف لديها خانة اختيار .
انقر على الزر نشر لإضافة الجميع تطبيق ملف s إلى ملف القائمة. إذا كان تطبيق الخاص بك يحتوي على المزيد ملف تنفيذي، وضع علامة على الملف التنفيذي الرئيسي لهذا توزيع كـ تطبيق بدء التشغيل بواسطة تحديد يؤشر الإدخال من القائمة نوع الملف المنسدلة. (إذا كان تطبيق الخاص بك يحتوي على ملف تنفيذي واحد فقط، MageUI.exe تعليمة للنقر.)
تحديد التبويب مطلوب أذونات و تحديد المستوى الثقة التي كنت في حاجة إلى تطبيق الخاص بك تأكيد. الافتراضي هو FullTrust، والتي ستكون مناسبة لمعظم التطبيقات.
تحديد ملف ، حفظ كـ من قائمة. يظهر صندوق حوار "خيارات توقيع" يطالبك بتسجيل التطبيق بيان.
إذا كان لديك شهادة مخزنة كـ ملف في النظام الملفات، واستخدم خيار تسجيل مع ملف الشهادة ، وحدد الشهادة من النظام الملفات باستخدام زر علامة القطع ( ... ). ثم اكتب كلمة مرور الشهادة.

-أو-

إذا كانت الشهادة الخاصة بك يتم الاحتفاظ به في مخزن شهادات يمكن الوصول إليها من جهاز الكمبيوتر الخاص بك، تحديد خيار التوقيع باستخدام شهادة مخزنة، و تحديد الشهادة من القائمة المتوفرة.
انقر فوق ‏‏موافق إلى تسجيل بيان تطبيق الخاص بك. يظهر مربع حوار حفظ باسم.
في "حفظ باسم" صندوق حوار تحديد الدليل الإصدار وثم انقر فوق حفظ.
تحديد ملف، جديد بيان نشر من قائمة لإنشاء عملية التوزيع بيان.
في التبويب اسم، حدد الاسم ورقم الإصدار لهذا توزيع (1.0.0.0 في هذا المثال). المعالج أيضا بتحديد التي تطبيق الخاص بك هو المضمنة، مثل x86.
تحديد علامة تبويب الوصف ، وتحديد قيم من الناشر و t Produc. (منتج هو الاسم الذي يمنح إلى تطبيق الخاص بك من قائمة ابدأ في Windows عند تثبيت تطبيق الخاص بك تشغيل كمبيوتر عميل للاستخدام دون اتصال.)
تحديد the خيارات توزيع علامة تبويب, و في the يبدأ الموقع صندوق نص, specify the الموقع of the بيان تطبيق تشغيل the ويب الخادم أو يجعله مشتركًا. For مثال, \\myServer\myShare\AppToDeploy.تطبيق.
If you تمت الإضافة the .نشر extension في a السابق step, also تحديد استخدم .نشر ملحق اسم الملف هنا.
تحديد the تحديث خيارات علامة تبويب, و specify how often you would مثل هذا تطبيق إلى تحديث. If your تطبيق uses UpdateCheckInfo إلى تحقق من تحديثات itself, مسح the هذا تطبيق should تحقق من تحديثات فحص صندوق.
تحديد the تطبيق مرجع علامة تبويب و then انقر the تحديد بيان زر. مفتوح مربع حوار تظهر.
تحديد the بيان تطبيق that you تاريخ الإنشاء earlier و then انقر فتح.
تحديد ملف ، حفظ كـ من قائمة. يظهر صندوق حوار "خيارات توقيع" يطالبك بتسجيل توزيع البيان.
إذا كان لديك شهادة مخزنة كـ ملف في النظام الملفات، واستخدم خيار تسجيل مع ملف الشهادة ، وحدد الشهادة من النظام الملفات باستخدام زر علامة القطع ( ... ). ثم اكتب كلمة مرور الشهادة.

-أو-

إذا كانت الشهادة الخاصة بك يتم الاحتفاظ به في مخزن شهادات يمكن الوصول إليها من جهاز الكمبيوتر الخاص بك، تحديد خيار التوقيع باستخدام شهادة مخزنة، و تحديد الشهادة من القائمة المتوفرة.
انقر ‏‏موافق إلى sign your بيان التوزيع. يظهر مربع حوار حفظ باسم.
في صندوق الحوار حفظ باسم ، الانتقال لأعلى direcإلىry واحد إلى الجذر للتوزيع ثم انقر فوق حفظ.
قم بنسخ الجميع الملفات الموجودة في الدليل توزيع إلى وجهة توزيع أو وسائط. قد يكون ذلك في أي مجلد موجود تشغيل موقع ويب أو موقع FTP أو يجعله مشتركًا ملف أو CD.
تزويد المستخدمين بعنوان URL أو UNC أو الوسيطة الفعلية المطلوب إلى يثّبت تطبيق الخاص بك. إذا قمت بتوفير عنوان URL أو UNC، فيجب منح المستخدمين مسار الكامل النشر بيان. على سبيل المثال، إذا كان AppToDeploy هو نشرة إلى http://webserver01/في الدليل AppToDeploy، المسار محدد موقع المعلومات الكامل سيكون http://webserver01/AppToDeploy/AppToDeploy.تطبيق.

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

إذا كنت بحاجة في نشر إصدار جديد من تطبيق، قم بإنشاء direcفيry جديد يسمى بعد الإصدار الجديد — على سبيل المثال، 1.0.0.1—و بنسخ ملفات تطبيق الجديد في في direcفيry الجديدة. بعد ذلك، فتحتاج إلى اتباع الخطوات السابقة لإنشاء وتسجيل ملف بيان تطبيق جديد والتحديث ثم قم بتسجيل توزيع البيان. Be careful to specify the same higher version in both the Mage.exe -New and –Update calls, as ClickOnce only updates higher versions, with the left-most integer most significant. إذا كنت تستخدم MageUI.exe، يمكنك محدث توزيع بيان بفتحه بتحديد علامة تبويب المرجع تطبيق ، والنقر فوق الزر تحديد البيان، ثم تحديد بيان تطبيق المحدث.