مشاركة عبر


الإرشادات التفصيلية: نسخ مستند إلى كمبيوتر المستخدم بعد تثبيت ClickOnce

ينطبق على

تنطبق المعلومات الموجودة في هذا الموضوع فقط على أنواع المشاريع وإصدارات Microsoft Office التالية: لمزيد من المعلومات، راجع الميزات المتوفرة بواسطة تطبيقات Office و نوع المشروع.

نوع المشروع

  • مشروعات على مستوى المستند

  • مشروعات على مستوى التطبيق

إصدار Microsoft Office

  • نظام 2007 Microsoft Office

  • Microsoft Office 2010

باستخدام إجراء post-deployment ClickOnce ، يمكنك تثبيت حلول Office على مستوى المستند ثم نسخ المستند إلى كمبيوتر المستخدم النهائي. يتطلب هذا تعديل بيان التطبيق ثم إعادة توقيع كل من التطبيق و بيانات النشر قبل التثبيت.

توضح هذه الإرشادات التفصيلية المهام التالية:

  • إنشاء حلول Office لنشرها.

  • تنفيذ إجراء ما بعد النشر(post-deployment) الذى ينسخ مستند إلى سطح مكتب المستخدم.

  • تعديل بيان التطبيق الخاص بحل Office لتشغيل الإجراء post-deployment.

  • إعادة توقيع التطبيق و بيان التوزيع.

ملاحظة

قد يعرض جهاز الكمبيوتر الخاص بك أسماء أو مواقع مختلفة لبعض عناصر واجهة مستخدم Visual Studio في الإرشادات التالية. يحدد كل من إصدار Visual Studio لديك والإعدادات المستخدمة هذه العناصر. لمزيد من المعلومات، راجع العمل مع إعدادات.

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

تحتاج إلى المكونات التالية لاستكمال هذه الإرشادات التفصيلية:

-

إصدار لـ Visual Studio 2010 يشمل أدوات مطوري Microsoft Office. لمزيد من المعلومات، راجع [تكوين كمبيوتر لتطوير حلول Office](bb398242\(v=vs.100\).md).
  • Excel 2007 أو Excel 2010.

  • كمبيوتر اختبار.

إنشاء مشروع جديد

أولاً، إنشاء مشروع مصنف Excel.

لإنشاء مشروع جديد في Excel

  • إنشاء مشروع المستوى مستند Excel. قم بتسمية المشروع ExcelWorkbookو احفظ المشروع إلى الدليل %USERPROFILE%\Documents\Visual Studio 10\Projects. لمزيد من المعلومات، راجع كيفية القيام بما يلي: إنشاء مشاريع Office في Visual Studio.

    يقوم Visual Studio بفتح مصنف Excel جديد في المصمم ثم يقوم بإضافة المشروع ExcelWorkbook إلى مستكشف الحلول.

إنشاء مشروع مكتبة الفئات الذي يعرّف إجراء Post-Deployment

يجب تعريف إجراء post-deployment في مكتبة فئة منفصلة. الإجراء post-deployment يقوم بنسخ المستند إلى كمبيوتر المستخدم النهائي.

لإنشاء مكتبة فئة خاصة بإجراء post-deployment

  1. من القائمة ملف، أشر إلى أضف، ثم انقر فوق مشروع جديد.

  2. في مربع الحوار إضافة مشروع جديد ، في الجزء القوالب المثبتة ، انقر فوق Windows.

  3. في الجزء قوالب انقر فوق مكتبة فئة

  4. في الحقل اسم ، اكتب FileCopyPDA، ثم انقر فوق موافق .

  5. في مستكشف الحلول، انقر فوق FileCopyPDA.

  6. في القائمة مشروع ، انقر فوقإضافة مرجع .

  7. In the Add Reference dialog box, in the .NET tab, add the following references:

    • في حالة إضافة أهداف مشروع الخاص بك Excel 3.5 إطار عمل.NET، يشير إلى Microsoft.VisualStudio.إلىols.Applications.وقت التشغيل.v10.0 و Microsoft.VisualStudio.إلىols.Applications.ServerDocument.v10.0.

    • إذا كان مشروع الخاص بك Excel تستهدف .NET Framework 4، قم بإضافة مراجع إلى Microsoft.VisualStudio.أدوات.Applications.وقت التشغيل و Microsoft.VisualStudio.أدوات.Applications.ServerDocument.

  8. في ملف التعليمات البرمجية Class1 ، قم بإضافة عبارات Using أو Imports التالية إلى أعلى ملف التعليمات البرمجية.

    Imports Microsoft.VisualStudio.Tools.Applications.Deployment
    Imports Microsoft.VisualStudio.Tools.Applications
    
    using Microsoft.VisualStudio.Tools.Applications.Deployment;
    using Microsoft.VisualStudio.Tools.Applications;
    using System.IO;
    
  9. قم بإعادة تسمية الفئة إلى FileCopyPDA ، ثم قم بإضافة التعليمة البرمجية التالية إلى فئة FileCopyPDA . يشير هذا الأمر إلى إن فئة FileCopyPDA ترث من IAddInPostDeploymentAction.

    Public Class FileCopyPDA
        Implements IAddInPostDeploymentAction
    
    public class FileCopyPDA : IAddInPostDeploymentAction
    
  10. قم بإضافة التعليمة البرمجية التالية لتطبيق أسلوب IAddInPostDeploymentAction.Execute . هذه التعليمة البرمجية تقوم بتنفيذ المهام التالية:

    • تقوم بنسخ ملف مصنف Excel إلى سطح المكتب الخاص بالمستخدم إذا كان الحل قد تم تثبيته أو تحديثه.

    • تقوم بتغيير خاصية _AssemblyLocation من مسار نسبي إلى مسار مؤهل بشكل كامل من أجل بيان النشر. يتم ذلك باستخدام أساليب AddCustomization و RemoveCustomization.

    • يقوم بحذف الملف إذا كان قد تم إزالة تثبيته.

      ملاحظة

      إجراء ينشر-توزيع هو تشغيلها أثناء الخطوة إلغاء التثبيت ل.NET Framework 3.5.

    Sub Execute(ByVal args As AddInPostDeploymentActionArgs) Implements IAddInPostDeploymentAction.Execute
        Dim dataDirectory As String = "Data\ExcelWorkbook.xlsx"
        Dim file As String = "ExcelWorkbook.xlsx"
        Dim sourcePath As String = args.AddInPath
        Dim deploymentManifestUri As Uri = args.ManifestLocation
        Dim destPath As String = Environment.GetFolderPath(Environment.SpecialFolder.DesktopDirectory)
        Dim sourceFile As String = System.IO.Path.Combine(sourcePath, dataDirectory)
        Dim destFile As String = System.IO.Path.Combine(destPath, file)
    
        Select Case args.InstallationStatus
            Case AddInInstallationStatus.InitialInstall, AddInInstallationStatus.Update
                System.IO.File.Copy(sourceFile, destFile)
                ServerDocument.RemoveCustomization(destFile)
                ServerDocument.AddCustomization(destFile, deploymentManifestUri)
                Exit Select
            Case AddInInstallationStatus.Uninstall
                If System.IO.File.Exists(destFile) Then
                    System.IO.File.Delete(destFile)
                End If
                Exit Select
        End Select
    End Sub
    
    public void Execute(AddInPostDeploymentActionArgs args) 
    {
        string dataDirectory = @"Data\ExcelWorkbook.xlsx";
        string file = @"ExcelWorkbook.xlsx";
        string sourcePath = args.AddInPath;
        Uri deploymentManifestUri = args.ManifestLocation;
        string destPath = Environment.GetFolderPath(Environment.SpecialFolder.DesktopDirectory);
        string sourceFile = System.IO.Path.Combine(sourcePath, dataDirectory);
        string destFile = System.IO.Path.Combine(destPath, file);
    
        switch (args.InstallationStatus)
        {
            case AddInInstallationStatus.InitialInstall:
            case AddInInstallationStatus.Update:
                File.Copy(sourceFile, destFile);
                ServerDocument.RemoveCustomization(destFile);
                ServerDocument.AddCustomization(destFile, deploymentManifestUri);
                break;
            case AddInInstallationStatus.Uninstall:
                if (File.Exists(destFile))
                {
                    File.Delete(destFile);
                }
                break;
        }
    }
    

بناء و نشر الحل

قم باستخدام معالج النشر Publish wizard أو صفحة المشروع Project Page لبناء و نشر حلول Office إلى كمبيوتر التطوير الخاص بك.

لنشر مشروع Excel

  1. في مستكشف الحلول، انقر بزر الماوس الأيمن فوق المشروع FileCopyPDA ثم انقر فوق بناء.

  2. في مستكشف الحلول، انقر بزر الماوس الأيمن فوق المشروع ExcelWorkbook ثم انقر فوق بناء.

  3. في مستكشف الحلول، انقر بزر الماوس الأيمن فوق المشروع ExcelWorkbook ومن ثم انقر فوق إضافة مرجع.

  4. في مربع الحوار إضافة مرجع ، انقر فوق علامة تبويب مشاريع .

  5. انقر فوق FileCopyPDA، ثم انقر فوق موافق .

  6. في مستكشف الحلول ، انقر فوق المشروع ExcelWorkbook.

  7. من القائمة مشروع انقر فوق مجلد جديد .

  8. اكتب Data ثم اضغط المفتاح Enter.

  9. في مستكشف الحلول ، انقر فوق المجلد بيانات .

  10. من القائمة مشروع انقر فوق إضافة عنصر موجود .

  11. في مربع الحوار إضافة عنصر موجود ، استعرض للوصول إلى دليل المشروع ExcelWorkbook.

  12. انقر فوق ExcelWorkbook.xlsxوانقر فوق أضف .

  13. في مستكشف الحلول، انقر فوق ExcelWorkbook.xlsx.

  14. في النافذة خصائص , قم بتغيير الخاصية إجراء البناء إلى المحتوى "Content" و الخاصية النسخ إلى دليل إخراج "Copy to "output directory إلى Copy if newer"انسخ لو أجدد"..

  15. قم بنشر المشروع ExcelWorkbookإلى المجلد c:\publish . لمزيد من المعلومات، راجع كيفية القيام بما يلي: نشر حل Office باستخدام ClickOnce.

تعديل بيان التطبيق

قم باستخدام محرر XML في Visual Studio لتعديل بيان التطبيق لتشغيل إجراء File Copy post-deployment. محتويات الملف الظاهر للتطبيق هو مشابهة للخزانة مواد التي lهوts الجميع محتويات صندوق؛ وتطبيق البيان lهوts الجميع التابعة وتجميعات prerequهوite. بيان التطبيق حلول المكتب أيضا بسرد تجميعات التي يجب أن يتم تم تحميله تطبيق المكتب لالمستوى التطبيق إضافة-زر 'Ins' والمستوى مستندات التخصيصات.

لإضافة تبعيات التثبيت إلى بيان التطبيق

  1. قم بفتح دليل c:\publish من خلال Windows Explorer.

  2. قم بفتح المجلد ملفات التطبيق "Application files" ثم قم بفتح المجلد ExcelWorkbook_1_0_0_0.

  3. قم بفتح الملف ExcelWorkbook.dll.manifest في محرر نص.

  4. قم بإضافة التعليمات البرمجية التالية بعد عنصر </vstav3:update> . للحصول على سمة الفئة الخاصة بعنصر <vstav3:entryPoint> ، استخدم بناء الجملة التالي: NamespaceName.ClassName. في هذا المثال، مساحة الاسم واسم الفئة متطابقان ، بحيث يكون اسم نقطة الإدخال الناتج هو FileCopyPDA.FileCopyPDA.

    <vstav3:postActions>
      <vstav3:postAction>
        <vstav3:entryPoint
          class="FileCopyPDA.FileCopyPDA">
          <assemblyIdentity
            name="FileCopyPDA"
            version="1.0.0.0"
            language="neutral"
            processorArchitecture="msil" />
        </vstav3:entryPoint>
        <vstav3:postActionData>
        </vstav3:postActionData>
      </vstav3:postAction>
    </vstav3:postActions>
    

إعادة توقيع البيانات

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

لإعادة توقيع التطبيق و بيان التوزيع.

  1. نسخ ملف الشهادة ExcelWorkbook_TemporaryKey.pfx من دليل الحل %USERPROFILE%\Documents\Visual Studio 10\Projects\ExcelWorkbook\ExcelWorkbook إلى الدليل c:\publish\Application Files\ExcelWorkbook_1_0_0_0.

  2. قم بفتح موجه أوامر Visual Studio.

  3. قم بالتغيير إلى دليل c:\publish\Application Files\ExcelWorkbook_1_0_0_0 .

  4. قم بتسجيل بيان التطبيق المعدل عن طريق الأمر التالي:

    mage -sign ExcelWorkbook.dll.manifest -certfile ExcelWorkbook_TemporaryKey.pfx
    

    تظهر الرسالة "ExcelWorkbook.dll.manifest successfully signed".

  5. قم بالتغيير إلى الدليل c:\publish .

  6. قم بتحديث ثم تسجيل بيان النشر عن طريق الأمر التالي:

    mage -update ExcelWorkbook.vsto -appmanifest "Application Files\Ex
    celWorkbook_1_0_0_0\ExcelWorkbook.dll.manifest" -certfile "Application Files\ExcelWorkbook_1_0_0_0\ExcelWorkbook_TemporaryKey.pfx"
    

    تظهر الرسالة "ExcelWorkbook.vsto successfully signed".

  7. قم بنسخ ملف ExcelWorkbook.vsto إلى الدليل c:\publish\Application Files\ExcelWorkbook_1_0_0_0 .

اختبار إجراءPost-Deployment

يضمن الإجراء التالي بتثبيت البيان المطور لمصنف Excel ونسخ المصنف إلى سطح مكتب المستخدم.

لاختبار الإجراء post-deployment

  1. قم بنسخ الدليل c:\publish إلى كمبيوتر اختبار.

  2. قم بتشغيل البرنامج Setup.exe أو إذا كانت المتطلبات الأساسية مثبتة بالفعل على كمبيوتر اختبار انقر نقراً مزدوجاً فوق بيان النشر ExcelWorkbook.vsto.

    يظهر مثبت Microsoft Office Customization .

  3. انقر فوق Install.

    يعرض مربع الحوار مثبت Microsoft Office Customization الرسالة التالية: "تم تثبيت Microsoft Office customization بنجاح." يتم نسخ مصنف Excel إلى سطح المكتب المستخدم النهائي.

  4. افتح الملف ExcelWorkbook.xlsx من سطح المكتب.

راجع أيضًا:

المهام

كيفية: يقوم بتوقيع مرة أخرى التطبيق نشر ملفات البيان

المبادئ

نشر حل Office متقدم

موارد أخرى

توزيع حلول Office