Membangun solusi Office

Secara umum, membangun dan men-debug proyek Office sama dengan membangun dan men-debug jenis proyek lain di Visual Studio, seperti Formulir Windows. Topik di bagian ini menjelaskan perbedaan yang memang ada. Untuk informasi umum tentang cara membuat aplikasi, lihat Mengkompilasi dan membangun di Visual Studio.

Catatan

Tertarik untuk mengembangkan solusi yang memperluas pengalaman Office di beberapa platform? Lihat model Add-in Office baru. Add-in Office memiliki jejak kecil dibandingkan dengan Add-in dan solusi VSTO, dan Anda dapat membuatnya dengan menggunakan hampir semua teknologi pemrograman web, seperti HTML5, JavaScript, CSS3, dan XML.

Output proyek untuk proyek Office

Lokasi output untuk proyek Office adalah projectname\bin\release atau projectname\bin\debug. Anda tidak dapat membangun ke direktori penyebaran.

Proyek tingkat dokumen

Saat Anda membuat proyek tingkat dokumen, item berikut disertakan dalam output proyek:

• Salinan dokumen proyek.

• Rakitan proyek dan semua rakitan yang dirujuk yang memiliki properti Salin Lokal mereka diatur ke true.

• Manifes aplikasi, yang memiliki ekstensi nama file .manifest. Untuk informasi selengkapnya, lihat Manifes aplikasi untuk solusi Office.

• Manifes penyebaran, yang memiliki ekstensi nama file .vsto. Untuk informasi selengkapnya, lihat Manifes penyebaran untuk solusi Office.

• File database program (PDB).

Catatan

Jika Anda membangun solusi tingkat dokumen ke lokasi jarak jauh alih-alih komputer lokal, tambahkan jalur yang sepenuhnya memenuhi syarat ke daftar Lokasi Tepercaya di Pusat Kepercayaan aplikasi. Untuk informasi selengkapnya, lihat bagian yang disebut Memberikan Kepercayaan kepada Dokumen dalam solusi Office Aman.

Proyek tingkat aplikasi

Saat Anda membangun proyek Add-in VSTO, item berikut disertakan dalam output proyek:

• Rakitan proyek dan semua rakitan yang dirujuk yang memiliki properti Salin Lokal mereka diatur ke true.

• Manifes aplikasi, yang memiliki ekstensi nama file .manifest. Untuk informasi selengkapnya, lihat Manifes aplikasi untuk solusi Office.

• Manifes penyebaran, yang memiliki ekstensi nama file .vsto. Untuk informasi selengkapnya, lihat Manifes penyebaran untuk solusi Office.

• File database program (PDB) untuk perakitan proyek.

  Proses build untuk proyek Add-in VSTO juga membuat sekumpulan entri registri pada komputer pengembangan yang diperlukan untuk memuat Add-in VSTO. Untuk informasi selengkapnya, lihat Entri registri untuk Add-in VSTO.

  Jika Anda membuat proyek Add-in Outlook VSTO yang berisi wilayah formulir, proses build menambahkan informasi tambahan berikut ke registri:

• Kunci untuk setiap kelas pesan yang terkait dengan satu atau beberapa wilayah formulir.

• Entri untuk setiap wilayah formulir dan nilai terkait yang mewakili nama Add-in Outlook VSTO.

  Outlook memerlukan informasi ini untuk memuat wilayah formulir.

Rakitan referensi

Anda dapat mereferensikan rakitan (termasuk proyek pustaka kelas) dari proyek Building Office Solutions Anda. Setiap rakitan yang dirujuk memiliki properti yang disebut Salin Lokal. Salin Lokal menunjukkan apakah rakitan disalin ke direktori output. Secara default diatur ke true. Setiap rakitan yang direferensikan yang telah menyalin Set lokal ke true disalin ke direktori output.

Keamanan selama proses build

Visual Studio secara otomatis mengonfigurasi pengaturan keamanan pada komputer pengembangan untuk memberikan kepercayaan kepada solusi selama proses build. Ini memungkinkan solusi berjalan saat Anda men-debugnya.

Proyek Office menggunakan sertifikat untuk memverifikasi penerbit. Visual Studio secara otomatis membuat sertifikat sementara untuk mengidentifikasi solusi Office, dan mengonfigurasi komputer pengembangan untuk mempercayai sertifikat sementara.

Untuk informasi selengkapnya, lihat Mengamankan solusi Office.

Proyek jaringan

Jika lokasi assembly atau dokumen berada di berbagi jaringan, pembaruan kebijakan keamanan lokal (Tingkat pengguna) tidak cukup untuk memungkinkan solusi dijalankan. Administrator harus memberikan kepercayaan penuh di tingkat Komputer untuk rakitan dan dokumen yang berada di berbagi jaringan sebelum solusi akan berjalan. Untuk informasi selengkapnya tentang cara mengatur kebijakan keamanan, lihat Mengamankan solusi Office.

Untuk proyek tingkat dokumen, Anda juga harus menambahkan lokasi dokumen yang sepenuhnya memenuhi syarat ke daftar folder tepercaya Office. Untuk informasi selengkapnya, lihat Memberikan kepercayaan ke dokumen.

Mengubah target platform

Secara default, target platform untuk proyek Office adalah CPU apa pun. Biasanya, Anda tidak boleh mengubah pengaturan ini. Solusi Office yang dibangun dengan pengaturan target platform CPU apa pun yang dijalankan dalam Microsoft Office 2013 atau Office 2010 versi 32-bit dan 64-bit.

Anda harus mengatur target platform ke x64 hanya jika Anda membuat solusi yang hanya akan berjalan dalam Microsoft Office 2013 atau Office 2010 versi 64-bit, dan solusi Anda memanggil API 64-bit asli. Untuk informasi selengkapnya tentang mengubah pengaturan target platform, lihat Cara: Mengonfigurasi proyek ke platform target.

Jika Anda menetapkan target platform ke x64, solusi tidak akan berjalan di Windows atau Office versi 32-bit. Target platform x64 memerlukan solusi untuk berjalan dalam proses 64-bit.

Gunakan perintah Bersihkan

Untuk menghapus file proyek bawaan dari komputer pengembangan, Anda dapat menggunakan perintah Bersihkan pada menu Build di Visual Studio. Perintah Bersihkan menghapus semua file di lokasi output build. Untuk proyek tingkat aplikasi, perintah Bersihkan juga menghapus entri registri yang dibuat oleh proses build.

Topik terkait

Judul	Deskripsi
Men-debug proyek Office	Menyajikan masalah yang terlibat dalam penelusuran kesalahan proyek Office.
Panduan: Membuat kustomisasi tingkat dokumen pertama Anda untuk Excel	Menunjukkan cara membuat kustomisasi tingkat dokumen dasar untuk Excel.
Cara: Mengaktifkan kembali Add-in VSTO yang telah dinonaktifkan	Menjelaskan cara mengaktifkan kembali Add-in VSTO yang telah dinonaktifkan dengan keras atau lunak.
Mendesain dan membuat solusi Office	Menyediakan tautan ke informasi tentang membuat solusi Office, dan tentang peran rakitan dalam solusi Anda.