Konfigurieren des Microsoft .NET-Add-Ins
Die allgemeinen Einstellungen und die Einstellungen für ein einzelnes Projekt werden in einem gemeinsamen Dialogfeld angezeigt.
Aufrufen der Einstellungen für das .NET-Add-In
- Klicken Sie auf .
- Wechseln Sie zur Registerkarte Parser.
- Klicken Sie auf die Option den Eintrag „Microsoft .NET Parser“.
- Klicken Sie auf Einstellungen.
Links können Sie auf die einzelnen Unterseiten für die allgemeinen Einstellungen und die Einstellungen für alle aktuell geladenen Projekte umschalten.
Externe Referenzen
In Microsoft .NET-Programmen können neben den standardmäßigen Steuerelementen auch selbst entwickelte Steuerelemente oder Steuerelemente von Drittanbietern verwendet werden. Um die Microsoft .NET-Dateien bearbeiten und im Dialogeditor die Formulare optimal anzeigen zu können, werden neben den Microsoft .NET-Dateien auch die zusätzlichen Steuerelemente benötigt. Dies gilt nicht nur für Binärdateien, sondern auch für die Ressourcendateien der Entwicklungsumgebung. Wenn SDL Passolo eine Quelldatei parst oder eine Zieldatei erzeugt, werden die verwendeten zusätzlichen Steuerelemente an folgenden Stellen gesucht:
- Das Verzeichnis, in dem die Quelldatei gespeichert ist.
- Das Verzeichnis, in dem das Passolo-Projekt gespeichert ist.
- Das Unterverzeichnis Referenzierte Assemblys des Verzeichnisses, in dem das Passolo-Projekt gespeichert ist.
- Das in den Einstellungen „Externe Referenzen“ angegebene Verzeichnis.
Der Passolo-Dialogeditor und die Passolo-Übersetzungsliste suchen ebenfalls im globalen Verzeichnis und im Projekt-Verzeichnis, nicht jedoch im Verzeichnis der Quelldatei.
Parser-Optionen
Wählen Sie hier, ob Sie neben Textlisten, Menüs und Formularen auch Bitmaps, Icons oder andere Binärdaten in die Passolo-Textlisten importieren und dort verarbeiten möchten.
Beim Erzeugen der Zieldatei können Sie auswählen, ob die Satellite-DLL sämtliche Informationen (Texte, Koordinaten, Eigenschaften) enthält oder nur solche, die sich beim Übersetzen geändert haben. Wählen Sie in diesem Fall die Option Nur geänderte Informationen schreiben aus. Die Satellite-DLL wird damit kleiner, kann aber immer noch für die Alignment-Funktion verwendet werden (siehe Übernehmen bestehender Übersetzungen).
Ist die Option Referenzierte Assemblys im Passolo-Projekt einbetten aktiviert, speichert Passolo automatisch alle benötigten Assemblys im Passolo-Projekt und entpackt sie, wenn zum Beispiel Formulare angezeigt werden sollen. Die Option vereinfacht die Verwaltung der Dateien, aber die Größe der Passolo-Projekte und Übersetzungspakete nimmt zu. Außerdem werden die Assemblys allen Passolo-Benutzern zugänglich gemacht, die an dem Projekt arbeiten. Da es möglich ist, aus den Assemblys den Source-Code zurückzugewinnen, ist diese Option nicht nimmer empfehlenswert.
Die Option Bearbeitete Assemblys speichern ist standardmäßig aktiviert, um die Verarbeitungsgeschwindigkeit beim Aktualisieren der Quelltextlisten zu erhöhen. Sollte es dabei zu Problemen kommen, können Sie diese Option deaktivieren.
Weitere Eigenschaften
Das Add-In für Microsoft .NET extrahiert alle Daten, die üblicherweise für die Lokalisierung benötigt werden. In speziellen Fällen kann es allerdings notwendig sein, zusätzliche Informationen zu extrahieren und zu bearbeiten. Klicken Sie auf Hinzufügen, um zusätzliche Eigenschaften anzugeben, die aus der Quelldatei extrahiert werden sollen. Das Dialogfeld .NET Control-Element wird angezeigt.
Geben Sie unter Eigenschaftsname den Namen der Eigenschaft (z. B. „DisplayMode“) an und unter Steuerelement-Typ die vollständige Typbezeichnung (z. B. „MyWindowsControlLibrary.UserControl1“). Statt des Namens des Steuerelements können Sie auch ein * angeben. In diesem Fall wird die Eigenschaft aus allen Steuerelementen extrahiert.
Deaktivieren Sie die Option „Übersetzbar“, um Eigenschaften zu extrahieren, die Strukturinformationen für den Aufbau des Formulars im Dialogeditor enthalten. Diese können vom Übersetzer nicht geändert werden.
Texteigenschaften werden automatisch in die Übersetzungsliste übernommen. Alle anderen Eigenschaften werden in Textform umgewandelt und können über den Menüpunkt Weitere Eigenschaften im Kontextmenü oder im Menü Bearbeiten in der Übersetzungsliste editiert werden. Eigenschaften mit symbolischen oder aufgezählten Werten können Sie bearbeiten, indem Sie die symbolischen Werte in einer Liste auswählen.
Ausgeschlossene Eigenschaften
Das Add-In für Microsoft .NET extrahiert alle Texteigenschaften. Es kann allerdings Texteigenschaften geben, die nicht übersetzt werden sollen. Diese können entweder in der Quelltextliste als „nicht zu übersetzen“ markiert oder in die Liste der ausgeschlossenen Eigenschaften aufgenommen werden.
Geben Sie die ausgeschlossenen Eigenschaften hier im selben Format wie die Weiteren Eigenschaften an.
Signierung
Assemblys können mit sogenannten Signaturen versehen sein. Signaturen können unter anderem eingesetzt werden, um ein nachträgliches Ändern von Assembly-Downstreams zu verhindern, durch die die Assemblys dann nicht mehr ausgeführt werden können. Ist das Quell-Assembly signiert, müssen auch die Satellite-Assemblys mit dem gleichen Schlüssel signiert werden. Dazu wird dieselbe Schlüsseldatei benötigt, die auch zum Signieren des Quell-Assemblys verwendet wurde. Bis einschließlich Framework 1.1 und auch für Framework 2.0 bei Managed C++ Assemblys werden die Informationen über den Schlüssel in der Assembly-Info des Quell-Assemblys abgelegt. Diese Informationen werden von Passolo automatisch ausgewertet und der Schlüssel relativ zur Quelldatei oder zum Passolo-Projekt gesucht und zum Signieren der Satellite-Assemblys verwendet.
.NET Assemblys ab 2.0, die mit C# oder Visual Basic entwickelt wurden, enthalten nicht automatisch Informationen zur Schlüsseldatei in der Assembly-Info. Für solche Assemblys können Sie die zu verwendende Schlüsseldatei unter Diese Schlüsseldatei verwenden angeben. Mit dieser Eingabe wird auch die Einstellungen aus der Assembly-Info der Quelldatei überschrieben.
Alternativ können Sie unter „In diesem Ordner nach Schlüsseldatei suchen“ den Ordner angeben, in dem nach einer Schlüsseldatei gesucht werden soll. Neben diesem Ordner sucht Passolo auch im Quelldateiordner, im Zielordner und im Projektordner nach Schlüsseldateien. Liefert die Assembly-Info der Quelldatei keine Schlüsseldatei, probiert Passolo alle Schlüsseldateien im Verzeichnis aus, um das Satellite-Assembly zu signieren. Sollten in einem Passolo-Projekt Assemblys mit unterschiedlichen Schlüsseldateien zusammengefasst sein, reicht es, Schlüsseldateien in einem der Suchverzeichnisse abzulegen.
Kann die passende Schlüsseldatei nicht gefunden werden, müssen die Satellite-Assemblys nachträglich signiert werden. Werden Satellite-Assemblys für signierte Quell-Assemblys erzeugt, informiert Passolo Sie im Ausgabe-Fenster darüber, ob die Satellite-Assemblys erfolgreich signiert werden konnten oder nicht.
Fehlerbehebung
Tritt während des Parsens einer Quelldatei ein Fehler auf, z. B. weil ein Basis-Formular nicht gefunden wurde oder ein Steuerelement fehlt, können Sie hier angeben, wie damit verfahren werden soll.
Auswahl:
| Ignorieren | Das Parsen wird fortgesetzt, wenn möglich. |
| Visuelle Bearbeitung deaktivieren | Das Parsen wird fortgeführt, aber das Windows-Format wird nicht im Dialogeditor angezeigt. |
| Parsen des Assemblys abbrechen | Das Parsen wird abgebrochen. |
Diagnosebericht
Aktivieren Sie den Diagnosebericht, um beim Parsen eine formatierte HTML-Datei zu erstellen, die detaillierte Informationen zum Vorgang enthält. Auftretende Fehler sind darin markiert und enthalten einen Verweis auf weitere Unterstützung.
Außerdem stehen folgende Optionen für den Diagnosebericht zur Auswahl: Betriebssystem-Info ausgeben, Installierte Software ausgeben und/oder Quellcode von InitializeComponent() ausgeben.
Die Option Komponententypen von WinForms untersuchen veranlasst Passolo dazu, schon beim Parsen der Quelldatei die verwendeten Steuerelemente erstellen, was sonst nur für die Anzeige im Dialogeditor erforderlich ist. Mögliche Ausnahmefehler werden für jede WinForm protokolliert und können im Diagnosebericht analysiert werden. Wenn Passolo nach der Aktivierung dieser Option weniger stabil läuft oder sogar abstürzt, kann es sein, dass ein oder mehrere Steuerelemente Fehler enthalten und zum Beispiel den Speicher oder die Aufrufliste überschreiben. Gerade für solche Fälle kann der Diagnosebericht nützliche Informationen enthalten.