Instalasi

Instalasi SDK Documentize

Documentize dapat diinstal melalui beberapa metode, masing‑masing disesuaikan dengan lingkungan pengembangan dan preferensi yang berbeda. Berikut adalah cara yang direkomendasikan untuk menginstal Documentize:

1. NuGet (Metode yang Disarankan)

NuGet adalah metode yang paling sederhana dan disarankan untuk menginstal Documentize, memastikan Anda selalu memiliki versi terbaru dan pembaruan langsung dalam lingkungan pengembangan Anda. Lihat detail lebih lanjut tentang metode instalasi ini di Cara menginstal SDK Documentize menggunakan NuGet.

2. Instaler MSI

Instaler MSI adalah pilihan yang nyaman jika Anda lebih suka memiliki DLL Documentize terinstal langsung ke sistem Anda. Metode ini ideal bagi pengembang yang ingin menggunakan Documentize di beberapa proyek tanpa harus mengelola file DLL secara manual. Lihat detail lebih lanjut tentang metode instalasi ini di Cara menginstal SDK Documentize menggunakan MSI.

3. Arsip ZIP

Bagi pengembang yang lebih menyukai pendekatan manual, arsip ZIP berisi DLL Documentize yang dapat diekstrak dan ditambahkan langsung ke proyek Anda. Lihat detail lebih lanjut tentang metode instalasi ini di Cara menginstal SDK Documentize menggunakan ZIP.

3 Nov 2026

Subbagian Instalasi

Installing Documentize via NuGet


Ujung

NuGet adalah pengelola paket gratis dan sumber terbuka untuk .NET yang menyederhanakan penambahan, penghapusan, dan pembaruan pustaka di proyek Visual Studio. Ia mengelola file pustaka, referensi, dan perubahan konfigurasi secara otomatis.

Cara Menginstal via NuGet Package Manager Console

  1. Buka Proyek Anda:

    • Jalankan Visual Studio dan buka aplikasi .NET Anda.
  2. Akses Package Manager Console:

    • Pilih Tools > NuGet Package Manager > Package Manager Console.
  3. Instal Paket:

    • Untuk menginstal rilis penuh terbaru, masukkan perintah Install-Package Documentize.
    • Untuk menginstal rilis terbaru termasuk perbaikan cepat, gunakan Install-Package Documentize -prerelease.
    • Tekan Enter untuk menjalankan perintah.

Cara Memperbarui Paket via NuGet Package Manager Console

Jika Anda sudah menginstal Documentize via NuGet dan ingin memperbarui ke versi terbaru:

  1. Buka Proyek Anda:

    • Jalankan Visual Studio dan buka aplikasi .NET Anda.
  2. Akses Package Manager Console:

    • Pilih Tools > NuGet Package Manager > Package Manager Console.
  3. Perbarui Paket:

    • Untuk memperbarui ke rilis penuh terbaru, masukkan Update-Package Documentize.
    • Untuk memperbarui ke rilis terbaru termasuk perbaikan cepat, gunakan Update-Package Documentize -prerelease.
    • Tekan Enter untuk menjalankan perintah.

Cara Menginstal via NuGet Package Manager GUI

  1. Buka Proyek Anda:

    • Jalankan Visual Studio dan buka aplikasi .NET Anda.
  2. Navigasi ke Manage NuGet Packages:

    • Dari menu Project, pilih Manage NuGet Packages.
  3. Cari Documentize:

    • Buka tab Browse dan ketik Documentize pada kotak pencarian.
  4. Instal Paket:

    • Klik Install/Update di sebelah versi terbaru Documentize.
    • Konfirmasi dengan mengklik Accept pada jendela pop‑up.

Kelebihan Menggunakan NuGet

  • Manajemen Ketergantungan Otomatis:

    • NuGet secara otomatis menangani ketergantungan, memastikan semua pustaka yang diperlukan disertakan dan diperbarui dengan tepat. Ini mengurangi risiko ketergantungan yang hilang atau tidak kompatibel.
  • Pembaruan yang Disederhanakan:

    • Memperbarui paket menjadi mudah dengan NuGet, baik melalui Package Manager Console maupun GUI. Hal ini memudahkan Anda menjaga pustaka tetap up‑to‑date dengan fitur terbaru dan perbaikan bug.
  • Terintegrasi dengan Visual Studio:

    • NuGet terintegrasi mulus dengan Visual Studio, menyediakan antarmuka yang ramah pengguna untuk mengelola paket tanpa meninggalkan lingkungan pengembangan.
  • Versi:

    • NuGet memungkinkan Anda menentukan dan mengelola berbagai versi pustaka, sehingga mudah untuk kembali ke versi sebelumnya atau menguji rilis baru tanpa mengganggu proses pengembangan.

Kekurangan Menggunakan NuGet

  • Terbatas pada Visual Studio:

    • NuGet terutama dirancang untuk penggunaan dalam Visual Studio. Meskipun dapat dipakai di lingkungan lain, integrasinya paling kuat di Visual Studio.
  • Potensi Konflik Versi:

    • Dalam proyek besar dengan banyak ketergantungan, mengelola versi dan menyelesaikan konflik dapat menjadi rumit. NuGet menyediakan alat untuk mengelolanya, namun memerlukan perhatian khusus.
  • Ketergantungan Jaringan:

    • Instalasi dan pembaruan paket memerlukan koneksi internet. Jika Anda bekerja di lingkungan dengan akses internet terbatas atau tidak ada, Anda mungkin perlu menggunakan metode offline atau mengunduh paket sebelumnya.
  • Kompleksitas untuk Proyek Besar:

    • Untuk proyek sangat besar dengan pohon ketergantungan yang luas, beban mengelola paket melalui NuGet dapat menjadi melelahkan. Pada kasus seperti itu, diperlukan alat atau strategi tambahan untuk mengelola ketergantungan secara efektif.

Installing Documentize via MSI

Ujung

Penginstal MSI adalah opsi yang mudah dan ramah pengguna untuk menginstal Documentize, terutama jika Anda lebih suka memiliki DLL yang diinstal secara sistem menyeluruh. Metode ini menyederhanakan proses instalasi dengan mengotomatiskan banyak langkah yang terlibat.

Cara Menginstal melalui Penginstal MSI

  1. Unduh Penginstal MSI:

    • Klik v26.11 MSI untuk mengunduh penginstal MSI versi terbaru dari Documentize.
  2. Jalankan Penginstal:

    • Klik dua kali file MSI yang diunduh untuk memulai wizard instalasi.
  3. Ikuti Wizard Instalasi:

    • Ikuti petunjuk yang muncul di layar yang disediakan oleh penginstal. Anda mungkin perlu menyetujui perjanjian lisensi dan memilih opsi instalasi.
  4. Selesaikan Instalasi:

    • Setelah instalasi selesai, DLL Documentize akan dipasang ke Global Assembly Cache (GAC) sistem Anda atau ke lokasi lain yang ditentukan.
  5. Verifikasi Instalasi:

    • Periksa bahwa DLL terpasang dengan benar dengan memverifikasi keberadaannya di direktori instalasi yang ditentukan atau di GAC.

Kelebihan Menggunakan Penginstal MSI

  • Kemudahan Penggunaan:

    • Penginstal MSI menyediakan proses instalasi yang sederhana dan terarah. Ia menangani semua konfigurasi yang diperlukan dan menempatkan DLL di lokasi pusat, memudahkan penggunaan Documentize di banyak proyek.
  • Instalasi Sistem Menyeluruh:

    • Metode MSI menginstal Documentize ke Global Assembly Cache (GAC) sistem atau lokasi pusat lainnya. Ini memungkinkan setiap aplikasi di sistem mengakses DLL tanpa harus merujuknya secara individual di setiap proyek.
  • Pembaruan Otomatis:

    • Jika Documentize menyediakan penginstal yang telah diperbarui, Anda dapat dengan mudah memperbarui instalasi dengan menjalankan file MSI baru, yang biasanya menangani proses pembaruan secara mulus.
  • Konsistensi:

    • Menggunakan penginstal MSI memastikan semua file yang diperlukan terinstal dengan benar dan konsisten di berbagai lingkungan, mengurangi risiko DLL yang hilang atau salah tempat.

Kekurangan Menggunakan Penginstal MSI

  • Fleksibilitas Terbatas:

    • Penginstal MSI memasang Documentize ke lokasi sistem menyeluruh, yang mungkin tidak cocok untuk semua lingkungan pengembangan. Ia mungkin kurang fleksibel untuk mengakomodasi konfigurasi atau versi khusus proyek.
  • Potensi Beban Tambahan:

    • Memasang DLL ke GAC dapat menambah beban dan kompleksitas, terutama dalam skenario di mana beberapa versi Documentize diperlukan secara bersamaan.
  • Penghapusan Manual:

    • Jika Anda perlu mencopot pemasangan Documentize, Anda harus menggunakan uninstaller yang disediakan oleh MSI, yang mungkin meninggalkan file atau konfigurasi residual jika tidak dikelola dengan baik.
  • Konflik Versi:

    • Instalasi sistem menyeluruh dapat menyebabkan konflik versi jika proyek yang berbeda memerlukan versi Documentize yang berbeda. Mengelola konflik ini mungkin memerlukan konfigurasi tambahan atau pembersihan.

Menginstal Documentize melalui ZIP

Ujung

Arsip ZIP sangat cocok untuk pengembang yang lebih suka pendekatan manual dalam mengelola pustaka. Metode ini memungkinkan Anda mengunduh dan mengekstrak file DLL yang diperlukan secara langsung tanpa bergantung pada manajer paket atau penginstal.

Cara Menginstal melalui Arsip ZIP

  1. Unduh Arsip ZIP:

    • Klik v26.11 ZIP untuk mengunduh versi terbaru Documentize dalam format arsip.
  2. Ekstrak Isi:

    • Setelah mengunduh, ekstrak konten file ZIP ke direktori pilihan Anda. Anda dapat menyimpan file‑file ini di direktori bersama atau di dalam struktur proyek Anda.
  3. Tambahkan Referensi ke Proyek Anda:

    • Buka proyek Anda di IDE (misalnya, Visual Studio).
    • Pilih Project > Add Reference > Browse dan arahkan ke direktori tempat Anda mengekstrak DLL.
    • Pilih file DLL yang relevan dan tambahkan sebagai referensi ke proyek Anda.
  4. Pembaruan Manual:

    • Jika versi baru Documentize dirilis, Anda harus mengunduh arsip ZIP yang diperbarui secara manual dan mengganti file DLL lama di proyek Anda dengan yang baru.

Kelebihan Menggunakan Arsip ZIP

  • Kontrol Penuh:

    • Anda memiliki kontrol penuh atas tempat dan cara penyimpanan serta referensi DLL dalam proyek. Ini berguna jika Anda menginginkan pengaturan khusus atau perlu mengelola dependensi secara manual.
  • Tidak Bergantung pada Manajer Paket:

    • Tidak seperti NuGet, Anda tidak mengandalkan manajer paket untuk menangani instalasi. Hal ini menguntungkan di lingkungan yang tidak menyediakan atau tidak menginginkan penggunaan manajer paket.
  • Portabilitas:

    • Arsip ZIP dapat dengan mudah dibagikan dan dipindahkan antar sistem, menjadikannya ideal untuk proyek yang memerlukan portabilitas atau distribusi tanpa alat eksternal.

Kekurangan Menggunakan Arsip ZIP

  • Manajemen Manual:

    • Tidak seperti NuGet, yang otomatis menangani pembaruan dan dependensi, dengan arsip ZIP Anda harus mengelola pembaruan secara manual dan memastikan semua DLL yang diperlukan terreferensi dengan benar.
  • Risiko Konflik Versi:

    • Jika Anda mengelola banyak proyek atau bekerja dalam tim, ada risiko konflik versi ketika proyek berbeda menggunakan versi DLL yang berbeda. Hal ini memerlukan pelacakan versi yang cermat antar proyek.
  • Tidak Ada Pembaruan Otomatis:

    • Anda tidak akan menerima pembaruan atau notifikasi otomatis ketika versi baru tersedia. Ini dapat menyebabkan penggunaan pustaka usang kecuali Anda secara rutin memeriksa pembaruan.

Lingkungan Non-Windows

Bekerja dengan .NET Core DLL di Lingkungan Non-Windows

Karena Documentize for .NET menyediakan dukungan .NET Standard 2.0 (.NET Core 2.0), ia dapat digunakan pada Aplikasi Core yang berjalan di sistem operasi mirip Linux. Kami terus bekerja meningkatkan dukungan .NET Core dalam API kami. Namun, ada beberapa operasi yang kami rekomendasikan kepada pelanggan untuk memperoleh hasil yang lebih baik saat menggunakan fitur Documentize for .NET. Silakan pasang:

  • paket libgdiplus
  • Paket dengan font yang kompatibel dengan Microsoft: ttf‑mscorefonts‑installer (misalnya, sudo apt-get install ttf-mscorefonts-installer). Font‑font ini harus ditempatkan di direktori /usr/share/fonts/truetype/msttcorefonts karena Documentize for .NET memindai folder tersebut pada sistem operasi mirip Linux. Jika sistem operasi memiliki folder/default lain untuk font, Anda harus menggunakan baris kode berikut sebelum melakukan operasi apa pun dengan Documentize:
    Documentize.Pdf.Text.FontRepository.Sources.Add(new FolderFontSource("<user's path to ms fonts>"));
 Indonesia