Εγκατάσταση του Documentize μέσω NuGet

Πώς να εγκαταστήσετε μέσω του κονσόλας διαχειριστή πακέτων NuGet

1. Ανοίξτε το Έργο σας:

   • Εκκινήστε το Visual Studio και ανοίξτε την εφαρμογή σας .NET.

2. Πρόσβαση στην Κονσόλα Διαχειριστή Πακέτων:

   • Μεταβείτε στο Εργαλεία > Διαχειριστής Πακέτων NuGet > Κονσόλα Διαχειριστή Πακέτων.

3. Εγκατάσταση του Πακέτου:

   • Για να εγκαταστήσετε τη τελευταία πλήρη κυκλοφορία, εισαγάγετε την εντολή Install-Package Documentize.
   • Για να εγκαταστήσετε την τελευταία κυκλοφορία συμπεριλαμβανομένων των hot fixes, χρησιμοποιήστε Install-Package Documentize -prerelease.
   • Πατήστε Enter για να εκτελέσετε την εντολή.

Πώς να ενημερώσετε το Πακέτο μέσω του κονσόλας διαχειριστή πακέτων NuGet

Αν έχετε ήδη εγκαταστήσει το Documentize μέσω NuGet και θέλετε να ενημερώσετε στην τελευταία έκδοση:

1. Ανοίξτε το Έργο σας:

   • Εκκινήστε το Visual Studio και ανοίξτε την εφαρμογή σας .NET.

2. Πρόσβαση στην Κονσόλα Διαχειριστή Πακέτων:

   • Μεταβείτε στο Εργαλεία > Διαχειριστής Πακέτων NuGet > Κονσόλα Διαχειριστή Πακέτων.

3. Ενημέρωση του Πακέτου:

   • Για να ενημερώσετε στην τελευταία πλήρη κυκλοφορία, εισαγάγετε Update-Package Documentize.
   • Για να ενημερώσετε στην τελευταία κυκλοφορία συμπεριλαμβανομένων των hot fixes, χρησιμοποιήστε Update-Package Documentize -prerelease.
   • Πατήστε Enter για να εκτελέσετε την εντολή.

Πώς να εγκαταστήσετε μέσω του GUI του διαχειριστή πακέτων NuGet

1. Ανοίξτε το Έργο σας:

   • Εκκινήστε το Visual Studio και ανοίξτε την εφαρμογή σας .NET.

2. Μεταβείτε στη Διαχείριση Πακέτων NuGet:

   • Από το μενού Έργο, επιλέξτε Διαχείριση Πακέτων NuGet.

3. Αναζητήστε το Documentize:

   • Μεταβείτε στην καρτέλα Πλοήγηση και εισάγετε το Documentize στο πλαίσιο αναζήτησης.

4. Εγκατάσταση του Πακέτου:

   • Κάντε κλικ στο Εγκατάσταση/Ενημέρωση δίπλα στην τελευταία έκδοση του Documentize.
   • Επιβεβαιώστε κάνοντας κλικ στο Αποδοχή στο αναδυόμενο παράθυρο.

Πλεονεκτήματα της Χρήσης του NuGet

• Αυτόματη Διαχείριση Εξαρτήσεων:

  • Το NuGet διαχειρίζεται αυτόματα τις εξαρτήσεις, διασφαλίζοντας ότι όλες οι απαιτούμενες βιβλιοθήκες περιλαμβάνονται και ενημερώνονται σωστά. Αυτό μειώνει τον κίνδυνο να λείπουν ή να είναι ασυμβίβαστες οι εξαρτήσεις.

• Απλοποιημένες Ενημερώσεις:

  • Η ενημέρωση των πακέτων είναι απλή με το NuGet, είτε μέσω της Κονσόλας Διαχειριστή Πακέτων είτε μέσω GUI. Αυτό διευκολύνει τη διατήρηση των βιβλιοθηκών σας ενημερωμένων με τις τελευταίες δυνατότητες και διορθώσεις σφαλμάτων.

• Ενοποίηση με το Visual Studio:

  • Το NuGet είναι άρρηκτα ενσωματωμένο με το Visual Studio, παρέχοντας μια φιλική προς το χρήστη διεπαφή για τη διαχείριση πακέτων χωρίς να χρειάζεται να αποχωρήσετε από το περιβάλλον ανάπτυξης.

• Διαχείριση Εκδόσεων:

  • Το NuGet σας επιτρέπει να προσδιορίζετε και να διαχειρίζεστε διαφορετικές εκδόσεις βιβλιοθηκών, επιτρέποντάς σας να επιστρέφετε εύκολα σε προηγούμενες εκδόσεις ή να δοκιμάζετε νέες κυκλοφορίες χωρίς να διαταράσσετε την ανάπτυξή σας.

Μειονεκτήματα της Χρήσης του NuGet

• Περιορισμένο στο Visual Studio:

  • Το NuGet έχει σχεδιαστεί κυρίως για χρήση εντός του Visual Studio. Ενώ μπορεί να χρησιμοποιηθεί σε άλλα περιβάλλοντα, η ενσωμάτωσή του είναι πιο ισχυρή στο Visual Studio.

• Πιθανότητα Συγκρούσεων Εκδόσεων:

  • Σε μεγαλύτερα έργα με πολλές εξαρτήσεις, η διαχείριση εκδόσεων και η επίλυση συγκρούσεων μπορεί να γίνουν περίπλοκες. Το NuGet παρέχει εργαλεία για τη διαχείριση αυτού, αλλά απαιτεί προσεκτική προσοχή.

• Εξάρτηση από το Διαδίκτυο:

  • Η εγκατάσταση και η ενημέρωση πακέτων απαιτούν σύνδεση στο διαδίκτυο. Αν εργάζεστε σε περιβάλλον με περιορισμένη ή καμία πρόσβαση στο διαδίκτυο, ίσως χρειαστεί να χρησιμοποιήσετε offline μεθόδους ή να προφορτώσετε πακέτα.

• Πολυπλοκότητα για Μεγάλα Έργα:

  • Για πολύ μεγάλα έργα με εκτενή δέντρα εξάρτησης, το βάρος της διαχείρισης πακέτων μέσω NuGet μπορεί να γίνει δυσχερές. Σε τέτοιες περιπτώσεις, μπορεί να χρειαστούν επιπλέον εργαλεία ή στρατηγικές για να διαχειριστείτε αποτελεσματικά τις εξαρτήσεις.

Εγκατάσταση του Documentize μέσω MSI

Πώς να Εγκαταστήσετε μέσω του Εγκαταστάτη MSI

1. Κατεβάστε τον Εγκαταστάτη MSI:

   • Κάντε κλικ στον v24.12 MSI για να κατεβάσετε τον εγκαταστάτη MSI για την τελευταία έκδοση του Documentize.

2. Εκτελέστε τον Εγκαταστάτη:

   • Διπλό κλικ στο ληφθέν αρχείο MSI για να ξεκινήσετε τον οδηγό εγκατάστασης.

3. Ακολουθήστε τον Οδηγό Εγκατάστασης:

   • Ακολουθήστε τις οδηγίες στην οθόνη που παρέχονται από τον εγκαταστάτη. Ίσως χρειαστεί να συμφωνήσετε με τη συμφωνία άδειας χρήσης και να επιλέξετε επιλογές εγκατάστασης.

4. Ολοκληρώστε την Εγκατάσταση:

   • Μόλις ολοκληρωθεί η εγκατάσταση, οι DLL του Documentize θα εγκατασταθούν στη Global Assembly Cache (GAC) του συστήματός σας ή σε άλλη καθορισμένη τοποθεσία.

5. Επαληθεύστε την Εγκατάσταση:

   • Ελέγξτε ότι οι DLL είναι σωστά εγκατεστημένες επιβεβαιώνοντας την παρουσία τους στον καθορισμένο κατάλογο εγκατάστασης ή στην GAC.

Πλεονεκτήματα Χρήσης του Εγκαταστάτη MSI

• Ευκολία Χρήσης:

  • Ο εγκαταστάτης MSI παρέχει μια απλή και καθοδηγούμενη διαδικασία εγκατάστασης. Αντιμετωπίζει όλες τις απαραίτητες ρυθμίσεις και τοποθετεί τις DLL σε κεντρική τοποθεσία, διευκολύνοντας τη χρήση του Documentize σε πολλές έργα.

• Εγκατάσταση σε Επίπεδο Συστήματος:

  • Η μέθοδος MSI εγκαθιστά το Documentize στη Global Assembly Cache (GAC) του συστήματος ή σε άλλη κεντρική τοποθεσία. Αυτό επιτρέπει σε οποιαδήποτε εφαρμογή στο σύστημα να έχει πρόσβαση στις DLL χωρίς να χρειάζεται να τις αναφέρετε ατομικά σε κάθε έργο.

• Αυτοματοποιημένες Ενημερώσεις:

  • Εάν το Documentize παρέχει έναν ενημερωμένο εγκαταστάτη, μπορείτε εύκολα να ενημερώσετε την εγκατάστασή σας τρέχοντας το νέο αρχείο MSI, το οποίο συνήθως χειρίζεται τη διαδικασία ενημέρωσης ομαλά.

• Σταθερότητα:

  • Χρησιμοποιώντας τον εγκαταστάτη MSI διασφαλίζεται ότι όλα τα απαραίτητα αρχεία εγκαθίστανται σωστά και σταθερά σε διαφορετικά περιβάλλοντα, μειώνοντας τον κίνδυνο να λείπουν ή να είναι τοποθετημένες κάπου αλλού οι DLL.

Μειονεκτήματα Χρήσης του Εγκαταστάτη MSI

• Περιορισμένη Ευελιξία:

  • Ο εγκαταστάτης MSI εγκαθιστά το Documentize σε μια κεντρική τοποθεσία του συστήματος, η οποία μπορεί να μην είναι κατάλληλη για όλα τα περιβάλλοντα ανάπτυξης. Μπορεί να μην έχει την ευελιξία να προσαρμόσει τις ρυθμίσεις ή τις εκδόσεις ανά έργο.

• Δυνητικό Υπερβολικό Φορτίο:

  • Η εγκατάσταση DLL στην GAC μπορεί να εισάγει υπερβολικό φορτίο και πολυπλοκότητα, ιδίως σε σενάρια όπου μπορεί να χρειαστούν ταυτόχρονα πολλές εκδόσεις του Documentize.

• Χειροκίνητη Αφαίρεση:

  • Εάν χρειαστεί να απεγκαταστήσετε το Documentize, πρέπει να χρησιμοποιήσετε τον απεγκαταστάτη που παρέχεται από το MSI, ο οποίος μπορεί να αφήσει υπολείμματα αρχεία ή ρυθμίσεις αν δεν διαχειριστεί σωστά.

• Συγκρούσεις Εκδόσεων:

  • Οι εγκαταστάσεις σε επίπεδο συστήματος μπορεί να οδηγήσουν σε συγκρούσεις εκδόσεων εάν διάφορα έργα απαιτούν διαφορετικές εκδόσεις του Documentize. Η διαχείριση αυτών των συγκρούσεων μπορεί να απαιτεί πρόσθετες ρυθμίσεις ή καθαρισμούς.

Εγκατάσταση του Documentize μέσω ZIP

Πώς να Εγκαταστήσετε μέσω Αρχείου ZIP

1. Κατεβάστε το Αρχείο ZIP:

   • Κάντε κλικ στο v24.12 ZIP για να κατεβάσετε την πιο πρόσφατη έκδοση του Documentize σε μορφή αρχείου.

2. Εξαγάγετε το Περιεχόμενο:

   • Μετά τη λήψη, εξαγάγετε το περιεχόμενο του αρχείου ZIP σε έναν κατάλογο της επιλογής σας. Μπορείτε να επιλέξετε να διατηρήσετε αυτά τα αρχεία σε έναν κοινόχρηστο κατάλογο ή μέσα στη δομή του έργου σας.

3. Προσθέστε Αναφορές στο Έργο σας:

   • Ανοίξτε το έργο σας στο IDE σας (π.χ., Visual Studio).
   • Μεταβείτε στο Έργο > Προσθήκη Αναφοράς > Περιήγηση και πλοηγηθείτε στον κατάλογο όπου εξαγάγατε τα DLLs.
   • Επιλέξτε τα σχετικά αρχεία DLL και προσθέστε τα ως αναφορές στο έργο σας.

4. Χειροκίνητες Ενημερώσεις:

   • Αν κυκλοφορήσει μια νέα έκδοση του Documentize, θα χρειαστεί να κατεβάσετε χειροκίνητα το ενημερωμένο αρχείο ZIP και να αντικαταστήσετε τα παλιά αρχεία DLL στο έργο σας με τα νέα.

Πλεονεκτήματα της Χρήσης του Αρχείου ZIP

• Πλήρης Έλεγχος:

  • Έχετε πλήρη έλεγχο σχετικά με το πού και πώς αποθηκεύονται και αναφέρονται τα DLLs στο έργο σας. Αυτό μπορεί να είναι ευεργετικό αν προτιμάτε μια προσαρμοσμένη ρύθμιση ή χρειάζεστε να διαχειριστείτε τις εξαρτήσεις χειροκίνητα.

• Καμία Εξάρτηση από Διαχειριστές Πακέτων:

  • Σε αντίθεση με το NuGet, δεν βασίζεστε σε έναν διαχειριστή πακέτων για να διαχειριστείτε τις εγκαταστάσεις. Αυτό μπορεί να είναι πλεονεκτικό σε περιβάλλοντα όπου οι διαχειριστές πακέτων δεν είναι διαθέσιμοι ή προτιμώνται.

• Φορητότητα:

  • Το αρχείο ZIP μπορεί να κοινοποιηθεί και να μετακινηθεί εύκολα σε διαφορετικά συστήματα, καθιστώντας το ιδανικό για έργα που χρειάζονται να είναι φορητά ή διανεμημένα χωρίς να βασίζεστε σε εξωτερικά εργαλεία.

Μειονεκτήματα της Χρήσης του Αρχείου ZIP

• Χειροκίνητη Διαχείριση:

  • Σε αντίθεση με το NuGet, όπου οι ενημερώσεις και η διαχείριση εξαρτήσεων είναι αυτοματοποιημένες, με το αρχείο ZIP, πρέπει να διαχειρίζεστε χειροκίνητα τις ενημερώσεις και να βεβαιώνεστε ότι όλα τα απαιτούμενα DLLs είναι σωστά αναφερόμενα.

• Κίνδυνος Συγκρούσεων Εκδόσεων:

  • Αν διαχειρίζεστε πολλαπλά έργα ή εργάζεστε σε μια ομάδα, υπάρχει κίνδυνος συγκρούσεων εκδόσεων αν διαφορετικά έργα χρησιμοποιούν διαφορετικές εκδόσεις των DLLs. Αυτό απαιτεί προσεκτική παρακολούθηση των εκδόσεων στα έργα.

• Καμία Αυτόματη Ενημέρωση:

  • Δεν θα λαμβάνετε αυτόματες ενημερώσεις ή ειδοποιήσεις όταν είναι διαθέσιμη μια νέα έκδοση. Αυτό μπορεί να οδηγήσει στον κίνδυνο χρήσης παλιών βιβλιοθηκών εκτός αν ελέγχετε τακτικά για ενημερώσεις.

Μη-Παράθυρα Περιβάλλον

Εργασία με .NET Core DLLs σε Μη-Παράθυρα Περιβάλλον

Καθώς το Documentize για .NET παρέχει υποστήριξη .NET Standard 2.0 (.NET Core 2.0), μπορεί να χρησιμοποιηθεί σε εφαρμογές Core που τρέχουν σε λειτουργικά συστήματα παρόμοια με το Linux. Συνεχώς εργαζόμαστε για τη βελτίωση της υποστήριξης .NET Core στο API μας. Ωστόσο, υπάρχουν ορισμένες διαδικασίες που συνιστούμε στους πελάτες μας να εκτελούν για να επιτύχουν καλύτερα αποτελέσματα κατά τη χρήση των χαρακτηριστικών του Documentize για .NET. Παρακαλούμε εγκαταστήστε:

• πακέτο libgdiplus
• Πακέτο με συμβατές γραμματοσειρές της Microsoft: ttf-mscorefonts-installer (π.χ., sudo apt-get install ttf-mscorefonts-installer). Αυτές οι γραμματοσειρές θα πρέπει να τοποθετηθούν στον φάκελο /usr/share/fonts/truetype/msttcorefonts καθώς το Documentize για .NET σαρώνει αυτόν τον φάκελο σε λειτουργικά συστήματα παρόμοια με το Linux. Σε περίπτωση που το λειτουργικό σύστημα έχει άλλο προεπιλεγμένο φάκελο/κατάλογο για γραμματοσειρές, θα πρέπει να χρησιμοποιήσετε την παρακάτω γραμμή κώδικα πριν εκτελέσετε οποιαδήποτε λειτουργία με το Documentize:

  Documentize.Pdf.Text.FontRepository.Sources.Add(new FolderFontSource("<path του χρήστη προς τις γραμματοσειρές ms>"));