Installation

FoxCore wird mit FoxCore.Runtime-Setup-3.4.2.exe installiert: das Setup registriert die COM-Engine für den ganzen Rechner, in beiden Sichten der Registrierung, und bringt eine Prüfung mit, die sagt, ob es wirklich geklappt hat. Die Lizenz wird nicht installiert: sie wird per Code aktiviert.

FoxCore ist digital signiert

Seit 3.4.2 tragen FoxCore.Runtime.dll, Nexum.dll und der Installer eine Herausgebersignatur auf den Namen Irwin Alfredo Rodriguez Gimenez, mit Zeitstempel. So sehen Sie sie: Rechtsklick auf die Datei → Eigenschaften → Digitale Signaturen, oder Get-AuthenticodeSignature in PowerShell, das Valid melden muss.

SmartScreen: Das Zertifikat ist neu, und Windows kann noch eine Zeit lang warnen. Erscheint „Der Computer wurde durch Windows geschützt“, klicken Sie auf Weitere Informationen: Dort muss Herausgeber: Irwin Alfredo Rodriguez Gimenez stehen. Steht das dort, Trotzdem ausführen; steht dort „Unbekannter Herausgeber“, ist die Datei nicht von uns: Führen Sie sie nicht aus.

Vor der Installation

Der FoxCore-Installer ist signiert, aber das Zertifikat ist neu, daher kann Windows beim ersten Start noch warnen. Hier steht, was Sie sehen werden, wie es weitergeht und wie Sie selbst prüfen können, dass die heruntergeladene Datei genau die ist, die wir veröffentlicht haben.

Die SmartScreen-Warnung

Erscheint beim Ausführen ein blaues Fenster mit „Der Computer wurde durch Windows geschützt“, klicken Sie auf „Weitere Informationen“ und prüfen Sie den Herausgeber: Er muss Irwin Alfredo Rodriguez Gimenez lauten. Die Warnung heißt nicht, dass mit der Datei etwas nicht stimmt: Windows hat nur noch nicht genug Downloads mit diesem Zertifikat gesehen, um es wiederzuerkennen.

Klicken Sie auf Weitere Informationen.
Klicken Sie auf Trotzdem ausführen.

Prüfen Sie vor diesem zweiten Klick den Hash: so wissen Sie, dass das, was Sie ausführen, von uns stammt und keine veränderte Kopie ist.

Wenn Ihr Virenscanner blockiert

Manche Virenscanner stellen selten gesehene Installer unter Quarantäne. Fügen Sie in dem Fall eine Ausnahme für den Installationsordner C:\Program Files (x86)\FoxCore.Runtime hinzu und starten Sie ihn erneut.

Wenn der Virenscanner der Firma gehört und Sie seine Regeln nicht ändern dürfen, geben Sie den SHA-256 unten an die Administration weiter: mehr braucht sie nicht, um die Datei freizugeben.

Prüfen Sie, was Sie heruntergeladen haben

Das sind die Daten der aktuellen Version und der Tag ihrer Veröffentlichung. Der Hash wird über die Datei berechnet, so wie das Portal sie ausliefert:

Datei	Version	Veröffentlicht	Größe	SHA-256
`FoxCore.Runtime-Setup-3.4.2.exe`	3.4.2	15. Sept. 2026	2.1 MB	`33BD10DCE4152526E007BCF1EBD2A71EC30706C43C81B476FEF481A39ABCBE2C`

Zum Prüfen öffnen Sie PowerShell in Ihrem Download-Ordner und führen aus:

Den SHA-256 der heruntergeladenen Datei berechnen

Get-FileHash -Algorithm SHA256 "$HOME\Downloads\FoxCore.Runtime-Setup-3.4.2.exe"

Stimmt der Wert mit der Tabelle überein, ist die Datei von uns und unversehrt. Stimmt er nicht, führen Sie sie nicht aus: laden Sie sie erneut herunter, und wenn es dann immer noch nicht passt, schreiben Sie an soporte@irwinrodriguez.dev.

Die Hashes werden bei jeder veröffentlichten Version neu gemessen. Wenn Sie eine ältere Version heruntergeladen haben, muss ihr Hash nicht mit dieser Tabelle übereinstimmen.

Voraussetzungen

Komponente	Anforderung
Windows	Windows 10 / 11
.NET Framework	4.8, und das Setup bricht ab, wenn es den 32-Bit-RegAsm nicht findet
Visual FoxPro	VFP 9.0 SP2, als Automatisierungsserver registriert (VisualFoxpro.Application.9)
Rechte	Administrator: registriert wird in HKLM, und nur das sieht ein Dienst oder eine geplante Aufgabe
Speicherplatz	10 MB

Visual FoxPro ist eine Warnung, kein Hindernis: seit 3.1.0 kann der Prozess, der die Aufgaben ausführt, auch eine eigene EXE sein, die als Automatisierungsserver registriert ist (Eigenschaft WorkerProgId).

Eine Anmerkung zu 32 und 64 Bit

Seit 3.4.0 trägt das Setup die Engine in beide Sichten der Registrierung ein, und beim Deinstallieren werden beide entfernt. Das sind zwei getrennte Registrierungen, nicht eine an zwei Stellen. Die 32-Bit-Sicht ist Pflicht: nur in die schaut vfp9.exe, und nur in 64 Bit registriert meldet VFP „Klasse nicht registriert“ über eine DLL, die sehr wohl registriert ist, nur eben dort, wo VFP nicht sucht. Die 64-Bit-Sicht ist die, die ein 64-Bit-Prozess sieht, der FoxCore erzeugt (ein Dienst, eine geplante Aufgabe, eine x64-.NET-Anwendung), und bis 3.3.0 scheiterten genau diese Fälle. Fehlt auf dem Rechner Framework64\, sagt das Setup es und macht weiter.

Schritt für Schritt

1. Installer herunterladen

Aus Ihrem Kundenportal, in der Detailansicht Ihrer Lizenz. Der Dateiname trägt die Version: FoxCore.Runtime-Setup-3.4.2.exe.

2. Ausführen

Es fragt einmal nach Administratorrechten. Genau dafür gibt es das Setup: die Registrierung für den ganzen Rechner.

3. „Installation jetzt prüfen“ angehakt lassen

Das führt verify.cmd aus, das das Objekt aus einem 32-Bit-Prozess erzeugt: dieselbe Sicht der Registrierung, die VFP hat. Das ist die Prüfung, die zählt. Nach einer Lizenz fragt es nicht mehr.

Was es tut und wo

Was	Wo
Installationsordner	`C:\Program Files (x86)\FoxCore.Runtime`, mit `bin\`, `demo\`, `tools\` und der Dokumentation
COM-Registrierung	HKLM, beide Sichten: mit dem 32-Bit-RegAsm (`Windows\Microsoft.NET\Framework\v4.0.30319\RegAsm.exe`) und, falls vorhanden, mit dem 64-Bit-RegAsm (`Framework64\`), mit `/codebase` und ohne `/tlb`
Ihre Lizenz	wird nicht installiert: es gibt keine Datei. Sie wird per Code mit `Activate()` aktiviert
Der demo-Ordner	bleibt für Benutzer beschreibbar, damit die Demo ihren Bericht dort schreibt, wo sie es sagt, und nicht im VirtualStore
Beim Deinstallieren	wird die COM-Engine in beiden Sichten abgemeldet: nur eine zu entfernen hinterlässt eine verwaiste Registrierung, die auf einen Ordner zeigt, den es nicht mehr gibt

Wenn Sie FoxCore vorher nur für Ihren Benutzer registriert hatten

Ein Eintrag in HKCU überdeckt den für den ganzen Rechner: Sie würden weiter die alte Version laden, ohne es zu merken. Das Setup versucht ihn zu entfernen und sagt es, wenn es nicht gelingt, statt zu schweigen: es läuft erhöht, und das HKCU dort muss nicht Ihres sein. Sie entfernen ihn selbst, ohne Erhöhung, mit unregister-user.cmd im Installationsordner. verify.cmd warnt weiter, solange er da ist.

Unbeaufsichtigte Installation

Um es in den Installer Ihrer eigenen Anwendung aufzunehmen:

Stille Installation über die Kommandozeile

FoxCore.Runtime-Setup-3.4.2.exe /VERYSILENT /SUPPRESSMSGBOXES /NORESTART

Die Lizenz

Die Installation installiert keine Lizenz, und das ist kein Versehen: seit 3.4.0 gibt es keine .lic-Datei mehr.
Die Lizenz ist ein JWT, den Sie beim Start Ihrer Anwendung an Activate() übergeben.
Sie wird immer verlangt, auch in der .exe, die Sie ausliefern. Bis 3.3.0 wurde sie nur in der IDE geprüft.

Wie sie aktiviert wird, woher der JWT kommt und was passiert, wenn er fehlt, steht unter Lizenzierung, mit dem vollständigen Code-Ausschnitt.

Prüfen aus VFP heraus

Im Befehlsfenster von Visual FoxPro:

Registrierung und Lizenz im Befehlsfenster prüfen

loRt = CREATEOBJECT("FoxCore.Runtime")
? loRt.Ping()                                && FoxCore.Runtime 3.4.2
? loRt.Activate(lcJwt)                       && .T. -- tu licencia, como cadena
loRt.Attach(_VFP)
? loRt.State, loRt.IsLicensed                && Attached  .T.
loRt.Shutdown()

Schlägt Ping() fehl, ist es die Registrierung: diese Seite. Gibt Activate() .F. zurück, ist es die Lizenz: die Seite Lizenzierung. Das sind zwei verschiedene Probleme und sie werden verschieden behoben.

Häufige Probleme

Problem	Ursache	Lösung
„Klasse nicht registriert“ beim Erzeugen von FoxCore.Runtime	Nicht registriert, oder nur in der Sicht, in die der Aufrufer nicht schaut	Eine Konsole als Administrator im Installationsordner öffnen und register.cmd ausführen: es trägt beide Sichten ein und nennt den genauen Grund, wenn es scheitert
Ich lade weiter eine alte Version	Eine Registrierung pro Benutzer (HKCU) überdeckt die des Rechners	unregister-user.cmd OHNE Erhöhung ausführen
„Der Worker ist nicht gestartet“	Kein VFP 9 als Automatisierungsserver registriert	Registrieren, oder WorkerProgId auf eine andere EXE zeigen lassen und mit ProbeWorker() prüfen
Activate() gibt .F. zurück	Der JWT ist unvollständig, gehört zu einem anderen Produkt oder ist abgelaufen	Noch einmal vollständig aus dem Portal kopieren. Die Einzelheiten stehen auf der Seite Lizenzierung
Das Setup startet nicht und spricht von .NET	.NET Framework 4.x fehlt (der 32-Bit-RegAsm wurde nicht gefunden)	.NET Framework 4.8 installieren und erneut ausführen

Weiter: Erste Schritte ->