Migrieren von AnyDAC-Anwendungen nach FireDAC

Aus RAD Studio
Wechseln zu: Navigation, Suche

Nach oben zu Migrieren nach FireDAC


In diesem Thema erhalten Sie einen Überblick über die Umgestaltungen, die bei der Integration von AnyDAC in RAD Studio FireDAC vorgenommen wurden. Darüber hinaus wird beschrieben, wie eine vorhandene AnyDAC-Codebasis nach FireDAC migriert wird.

Änderungen von FireDAC im Vergleich zu AnyDAC

Im Folgenden finden Sie einige signifikante Unterschiede zwischen AnyDAC, der ersten Realisierung von FireDAC, und FireDAC:

  • Die API wurde umbenannt und enthält jetzt neue Unit-Namen und neue API-Präfixe.
    • Es wurden hierarchische Namespaces implementiert.
      • Die früheren Unit-Namen hatten die folgende Form:
        uAD<Schicht><Rolle>.pas
      • Die neuen FireDAC-Unit-Namen haben im Allgemeinen die folgende Form:
        FireDAC.<Schicht>.<Rolle>.pas
      • Dazu einige Beispiele:
        uADCompClient -> FireDAC.Comp.Client
        uADStanOption -> FireDAC.Stan.Option
        uADPhysIB -> FireDAC.Phys.IB
  • Bei FireDAC-Komponenten wurde das Namenspräfix von TADXxxx in TFDXxxx geändert.
    • Bei globalen Funktionen wurde das Namenspräfix von ADXxx in FDXxx geändert.
    • Bei Exception-Klassen wurde der Name von EADXxx in EFDXxx geändert.
      Einige Beispiele:
  • Laufzeit-Packages wurden umbenannt:
    • FireDACCommon190, FireDACCommonDriver190, FireDACADSDriver190, FireDACASADriver190, FireDACDataSnapDriver190, FireDACDb2Driver190, FireDACDBXDriver190, FireDACIBDriver190, FireDACMSAccDriver190, FireDACMSSQLDriver190, FireDACMySQLDriver190, FireDACODBCDriver190, FireDACOracleDriver190, FireDACPgDriver190, FireDACSqliteDriver190, FireDAC190, fmxFireDAC190, vclFireDAC190
  • Konfigurationsdateien wurden von ADXxx.ini in FDXxx.ini umbenannt und nach C:\Users\Public\Documents\Embarcadero\Studio\20.0\FireDAC verschoben:
    • Der Registrierungsschlüssel für die FireDAC-Konfiguration wurde nach HKCU\Software\Embarcadero\FireDAC verschoben.
      Die Schlüsselwerte zeigen auf FireDAC-Konfigurationsdateien:
      • DriverFile auf FDDrivers.ini
      • ConnectionDefFile auf FDConnectionDefs.ini
  • FireDAC-Beispiele befinden sich im Verzeichnis <RAD Studio Samples>\Delphi\Database\FireDAC.
    Weitere Informationen über Beispiele/Demos finden Sie unter Beschreibung der Beispiele.
  • Tools aus Versionen von RAD Studio vor XE5 werden nicht mehr unterstützt.

Online-Hilfe für FireDAC

Migrieren von AnyDAC nach FireDAC

Folgende Hilfsmittel stehen Ihnen zur Vereinfachung und Automatisierung der Migration Ihrer Anwendungen von der alten zur neuen FireDAC-API zur Verfügung:

reFind ist ein Befehlszeilenhilfsprogramm, das mit PCRE (Perl Compatible Regular Expressions) Entitäten in Dateien umbenennt.

Gehen Sie zum Migrieren einer AnyDAC-App nach FireDAC folgendermaßen vor:

  1. Erstellen Sie eine Sicherungskopie von Ihrer Anwendung.
  2. Öffnen Sie das MS Windows-Befehlszeilenfenster.
  3. Wechseln Sie zum Stammordner Ihrer Projektquelldateien.
  4. Führen Sie für Units und Member die beiden folgenden Befehle aus:
    • <RAD Studio>\Bin\reFind *.pas *.dpk *.dpr *.dproj *.inc /S /Y /I /W /B:0 /X:<RAD Studio Demos>\Delphi\Database\FireDAC\Tool\reFind\AD2FDMigration\FireDAC_Rename_Units.txt
    • <RAD Studio>\Bin\reFind *.pas *.dfm *.dpk *.dpr *.inc /S /Y /I /B:0 /X:<RAD Studio Demos>\Delphi\Database\FireDAC\Tool\reFind\AD2FDMigration\FireDAC_Rename_API.txt
  5. Wenn Ihre Anwendung mit Laufzeit-Packages erstellt wurde, dann benennen Sie die Package-Verweise entsprechend den obigen Package-Namen um.
  6. Wenn Ihre Anwendung Treiberkonfigurations- und/oder persistente Verbindungsdefinitionsdateien verwendet, dann benennen Sie die Dateien entsprechend den obigen Konfigurationsdateinamen um.
  7. Überprüfen Sie die von reFind vorgenommenen Änderungen.
Hinweise:
  • Dieses Vorgehen garantiert keine 100-prozentig automatische und erfolgreiche Migration, da es regelbasiert ist und es keine exakte Namensübereinstimmung gibt.
  • Es wird dringend empfohlen, dass Sie zuerst eine Sicherungskopie all Ihrer Projekt erstellen. Sie können mit reFind auch Sicherungskopien der geänderten Dateien erstellen.

Siehe auch