Instalasi

Instalasi Documentize SDK

Documentize dapat diinstal melalui berbagai metode, masing-masing disesuaikan dengan lingkungan pengembangan dan preferensi yang berbeda. Berikut adalah cara yang dianjurkan untuk menginstal Documentize:

1. NuGet (Metode Diutamakan)

NuGet adalah metode yang paling langsung dan diutamakan untuk menginstal Documentize, memastikan bahwa Anda selalu memiliki versi dan pembaruan terbaru langsung di dalam lingkungan pengembangan Anda. Cek lebih banyak detail tentang metode instalasi ini di Cara menginstal Documentize SDK menggunakan NuGet.

2. Penginstal MSI

Penginstal MSI adalah pilihan yang nyaman jika Anda lebih suka menginstal DLL Documentize langsung ke sistem Anda. Metode ini ideal untuk pengembang yang mungkin ingin menggunakan Documentize di berbagai proyek tanpa perlu mengelola file DLL secara manual. Cek lebih banyak detail tentang metode instalasi ini di Cara menginstal Documentize SDK menggunakan MSI.

3. Arsip ZIP

Untuk pengembang yang lebih suka pendekatan manual, arsip ZIP berisi DLL Documentize, yang dapat diekstrak dan ditambahkan ke proyek Anda secara langsung. Cek lebih banyak detail tentang metode instalasi ini di Cara menginstal Documentize SDK menggunakan ZIP.

28 Des 2024

Subbagian Instalasi

Menginstal Documentize melalui NuGet

Ujung

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

Cara Menginstal melalui Konsol Manajer Paket NuGet

  1. Buka Proyek Anda:

    • Jalankan Visual Studio dan buka aplikasi .NET Anda.

  2. Akses Konsol Manajer Paket:

    • Navigasikan ke Alat > Manajer Paket NuGet > Konsol Manajer Paket.

  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 mengeksekusi perintah.

Cara Memperbarui Paket melalui Konsol Manajer Paket NuGet

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

  1. Buka Proyek Anda:

    • Jalankan Visual Studio dan buka aplikasi .NET Anda.

  2. Akses Konsol Manajer Paket:

    • Navigasikan ke Alat > Manajer Paket NuGet > Konsol Manajer Paket.

  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 mengeksekusi perintah.

Cara Menginstal melalui GUI Manajer Paket NuGet

  1. Buka Proyek Anda:

    • Jalankan Visual Studio dan buka aplikasi .NET Anda.

  2. Navigasi ke Kelola Paket NuGet:

    • Dari menu Proyek, pilih Kelola Paket NuGet.

  3. Cari Documentize:

    • Pergi ke tab Telusuri dan masukkan Documentize ke dalam kotak pencarian.

  4. Instal Paket:

    • Klik Instal/Pembaruan di samping versi terbaru dari Documentize.
    • Konfirmasikan dengan mengklik Terima di jendela pop-up.

Kelebihan Menggunakan NuGet

  • Manajemen Ketergantungan Otomatis:

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

  • Pembaruan yang Disederhanakan:

    • Memperbarui paket sangat sederhana dengan NuGet, baik melalui Konsol Manajer Paket atau GUI. Ini memudahkan untuk menjaga pustaka Anda tetap terbaru dengan fitur-fitur dan perbaikan bug terbaru.

  • Terintegrasi dengan Visual Studio:

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

  • Versi:

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

Kekurangan Menggunakan NuGet

  • Terbatas pada Visual Studio:

    • NuGet terutama dirancang untuk digunakan di dalam Visual Studio. Meskipun dapat digunakan di lingkungan lain, integrasinya paling kuat di Visual Studio.

  • Kemungkinan Konflik Versi:

    • Dalam proyek yang lebih besar dengan banyak ketergantungan, mengelola versi dan menyelesaikan konflik bisa menjadi kompleks. NuGet menyediakan alat untuk mengelola ini, tetapi memerlukan perhatian yang cermat.

  • Ketergantungan Jaringan:

    • Menginstal dan memperbarui paket memerlukan koneksi internet. Jika Anda bekerja di lingkungan dengan akses internet yang terbatas atau tidak ada, Anda mungkin perlu menggunakan metode offline atau mengunduh paket sebelumnya.

  • Kompleksitas untuk Proyek Besar:

    • Untuk proyek yang sangat besar dengan pohon ketergantungan yang luas, beban pengelolaan paket melalui NuGet bisa menjadi merepotkan. Dalam kasus seperti itu, alat tambahan atau strategi mungkin diperlukan untuk mengelola ketergantungan secara efektif.

Menginstal Documentize melalui MSI

Ujung

Installer MSI adalah pilihan yang nyaman dan ramah pengguna untuk menginstal Documentize, terutama jika Anda lebih suka menginstal DLL secara global di sistem. Metode ini menyederhanakan proses instalasi dengan mengotomatisasi banyak langkah yang terlibat.

Cara Menginstal melalui Installer MSI

  1. Unduh Installer MSI:

    • Klik v24.12 MSI untuk mengunduh installer MSI untuk versi terbaru dari Documentize.

  2. Jalankan Installer:

    • Klik dua kali file MSI yang diunduh untuk meluncurkan panduan instalasi.

  3. Ikuti Panduan Instalasi:

    • Ikuti petunjuk di layar yang diberikan oleh installer. Anda mungkin perlu menyetujui perjanjian lisensi dan memilih opsi instalasi.

  4. Selesaikan Instalasi:

    • Setelah instalasi selesai, DLL Documentize akan diinstal ke dalam Global Assembly Cache (GAC) sistem Anda atau lokasi lain yang ditentukan.

  5. Verifikasi Instalasi:

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

Kelebihan Menggunakan Installer MSI

  • Kemudahan Penggunaan:

    • Installer MSI menyediakan proses instalasi yang sederhana dan terarah. Ini menangani semua konfigurasi yang diperlukan dan menempatkan DLL di lokasi pusat, sehingga mudah untuk menggunakan Documentize di berbagai proyek.

  • Instalasi Sistem secara Global:

    • Metode MSI menginstal Documentize ke dalam Global Assembly Cache (GAC) sistem atau lokasi pusat lainnya. Ini memungkinkan aplikasi mana pun di sistem untuk mengakses DLL tanpa perlu merujuknya secara individual di setiap proyek.

  • Pembaruan Otomatis:

    • Jika Documentize menyediakan installer yang diperbarui, Anda dapat dengan mudah memperbarui instalasi Anda dengan menjalankan file MSI baru, yang biasanya menangani proses pembaruan dengan lancar.

  • Konsistensi:

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

Kekurangan Menggunakan Installer MSI

  • Fleksibilitas Terbatas:

    • Installer MSI menginstal Documentize ke lokasi global sistem, yang mungkin tidak cocok untuk semua lingkungan pengembangan. Ini mungkin kurang fleksibel untuk mengakomodasi konfigurasi atau versi spesifik proyek.

  • Potensi Overhead:

    • Menginstal DLL ke GAC dapat memperkenalkan overhead dan kompleksitas, terutama dalam skenario di mana beberapa versi Documentize mungkin diperlukan secara bersamaan.

  • Penghapusan Manual:

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

  • Konflik Versi:

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

Menginstal Documentize melalui ZIP

Ujung

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

Cara Menginstal lewat Arsip ZIP

  1. Unduh Arsip ZIP:

    • Klik v24.12 ZIP untuk mengunduh versi terbaru dari Documentize dalam format arsip.

  2. Ekstrak Konten:

    • Setelah mengunduh, ekstrak isi file ZIP ke direktori pilihan Anda. Anda dapat memilih untuk menyimpan file ini di direktori bersama atau di dalam struktur proyek Anda.

  3. Tambahkan Referensi ke Proyek Anda:

    • Buka proyek Anda di IDE Anda (misalnya, Visual Studio).
    • Pergi ke Proyek > Tambah Referensi > Telusuri dan navigasikan ke direktori tempat Anda mengekstrak DLL.
    • Pilih file DLL yang relevan dan tambahkan sebagai referensi ke proyek Anda.

  4. Pembaruan Manual:

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

Pro Menggunakan Arsip ZIP

  • Kontrol Penuh:

    • Anda memiliki kontrol penuh atas di mana dan bagaimana DLL disimpan dan direferensikan dalam proyek Anda. Ini bisa menguntungkan jika Anda lebih suka pengaturan kustom atau perlu mengelola ketergantungan secara manual.

  • Tidak Bergantung pada Manajer Paket:

    • Tidak seperti NuGet, Anda tidak bergantung pada manajer paket untuk menangani instalasi. Ini bisa menguntungkan di lingkungan di mana manajer paket tidak tersedia atau tidak diinginkan.

  • Portabilitas:

    • Arsip ZIP dapat dengan mudah dibagikan dan dipindahkan ke berbagai sistem, menjadikannya ideal untuk proyek yang perlu berpindah atau disebarkan tanpa bergantung pada alat eksternal.

Kontra Menggunakan Arsip ZIP

  • Pengelolaan Manual:

    • Tidak seperti NuGet, di mana pembaruan dan pengelolaan ketergantungan otomatis, dengan arsip ZIP, Anda harus secara manual mengelola pembaruan dan memastikan semua DLL yang diperlukan direferensikan dengan benar.

  • Risiko Konflik Versi:

    • Jika Anda mengelola beberapa proyek atau bekerja dalam tim, ada risiko konflik versi jika proyek yang berbeda menggunakan versi DLL yang berbeda. Ini memerlukan pelacakan versi yang teliti di seluruh proyek.

  • Tidak Ada Pembaruan Otomatis:

    • Anda tidak akan menerima pembaruan otomatis atau pemberitahuan saat versi baru tersedia. Ini dapat menyebabkan risiko menggunakan pustaka yang sudah usang kecuali Anda secara rutin memeriksa pembaruan.

Lingkungan Non-Windows

Bekerja dengan DLL .NET Core di Lingkungan Non-Windows

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

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