Exemplarische Vorgehensweise: Packen einer Projektmappe für intelligente Geräte zur Bereitstellung
Aktualisiert: November 2007
Diese exemplarische Vorgehensweise veranschaulicht, wie die Anwendung und ihre Ressourcen mithilfe von Visual Studio in eine CAB-Datei gepackt werden, um sie auf intelligenten Geräten für Endbenutzer bereitzustellen.
.gif "Hinweis") Hinweis: |
|---|
Ihr Computer zeigt möglicherweise für einige der Elemente der Visual Studio-Benutzeroberfläche in der folgenden Anleitung andere Namen oder Standorte an. Diese Elemente sind von der jeweiligen Visual Studio-Version und den verwendeten Einstellungen abhängig. Weitere Informationen finden Sie unter Visual Studio-Einstellungen. |
Am Beginn dieser exemplarischen Vorgehensweise steht eine Projektmappe für intelligente Geräte, die in Visual Basic, Visual C# oder Visual C++ geschrieben wurde. Weitere Informationen finden Sie unter Exemplarische Vorgehensweise: Erstellen von Windows Forms-Anwendungen für ein Gerät.
Diese Vorgehensweise erläutert die folgenden Aufgaben:
Hinzufügen eines CAB-Projekts zu der Projektmappe
Ändern des Produktnamens
Ändern des Ausgabepfads
Auffüllen der CAB-Datei mit der primären Ausgabe der Anwendung
Fügen Sie ggf. Abhängigkeiten hinzu.
Erstellen einer Verknüpfung zur Anwendung
Verschieben der Verknüpfung in das Startmenü oder den Programmordner.
Ändern Sie einen Registrierungseintrag.
Vorbereitungsmaßnahmen
Eine vorhandene Projektmappe für intelligente Geräte. Für diese exemplarische Vorgehensweise sollten Sie ein einfaches Projekt, wie das unter Exemplarische Vorgehensweise: Erstellen von Windows Forms-Anwendungen für ein Gerät beschriebene, erstellen.
Einrichten des CAB-Projekts
So fügen Sie der Projektmappe ein CAB-Projekt für intelligente Geräte hinzu
Öffnen Sie das vorhandene Projekt für intelligente Geräte, und stellen Sie sicher, dass der Projektmappen-Explorer sichtbar ist.
Zeigen Sie im Menü Datei auf Hinzufügen, und klicken Sie auf Neues Projekt.
Das Dialogfeld Neues Projekt hinzufügen wird angezeigt.
Erweitern Sie im Bereich Projekttypen den Knoten Andere Projekttypen, und klicken Sie dann auf Setup und Bereitstellung.
Klicken Sie im Bereich Vorlagen auf CAB-Projekt für intelligente Geräte.
Dies ist der einzige für intelligente Geräte gültige CAB-Projekttyp. Die anderen Projekttypen sind nur für Desktopprojektmappen bestimmt.
Geben Sie CABProject in das Feld Name ein, und klicken Sie dann auf OK.
Das CAB-Projekt wird der Projektmappe hinzugefügt und ist im Projektmappen-Explorer sichtbar. Die zwei Bereiche im Dateisystem-Editor werden nun angezeigt.
Anpassen des CAB-Projekts
So ändern Sie den Produktnamen und andere Projekteigenschaften
Klicken Sie im Projektmappen-Explorer auf CABProject aus, falls die Option nicht bereits ausgewählt ist.
Klicken Sie im Menü Ansicht auf Eigenschaftenfenster, um das Eigenschaftenfenster zu öffnen.
Ändern Sie im Feld ProductName des Eigenschaftenrasters den Wert in MyProduct.
Der Wert der ProductName-Eigenschaft bestimmt den Namen, der für die Anwendung in Ordnernamen und im Dialogfeld Software angezeigt wird.
In diesem Fenster können Sie auch den Namen des Herstellers ändern und die niedrigste und höchste zulässige Version des Betriebssystems angeben.
Sie können die OSVersionMin-Eigenschaft auf 4.21 festlegen, um anzugeben, dass die Pocket PC-Anwendung Unterstützung für die Bildschirmausrichtung bietet. Wenn Sie diese Eigenschaft auf 4.21 festlegen, kann die Anwendung allerdings nicht auf Pocket PCs mit Windows Mobile 2003 oder früher installiert werden. Damit die Installation auf solchen Geräten möglich ist und um auch die Unterstützung für die Bildschirmausrichtung bei neueren Geräten festzulegen, müssen Sie die INF-Datei manuell bearbeiten und die BuildMax-Eigenschaft auf einen der folgenden Werte festlegen:
0xA0000000, um festzulegen, dass die Anwendung quadratische Displays (240 x 240 Pixel) unterstützt
0xC0000000, um anzugeben, dass die Anwendung Bildschirmdrehung unterstützt
- oder -
0xE0000000, um anzugeben, dass die Anwendung quadratische Displays und Bildschirmdrehung unterstützt
Weitere Informationen finden Sie im MSDN-Artikel Developing Screen Orientation-Aware Applications (in englischer Sprache).
Für Pocket PC-Projektmappen, die auf Windows Mobile 2003 SE und früheren Versionen basieren, müssen die Compress-Eigenschaft und die NoUninstall Device Deployment-Eigenschaft auf false festgelegt werden. Beachten Sie, dass diese Option für mit Compact Framework 2.0 ausgestattete Geräte auf true festgelegt werden kann. Weitere Informationen hierzu finden Sie unter Eigenschaftenfenster, Cab-Projekt für intelligente Geräte.
Geben Sie bei Verwendung einer Windows CE-Setup-DLL in diesem Eigenschaftenraster den Dateinamen und den Speicherort an. Weitere Informationen zu Windows CE-Setup-DLLs finden Sie in der Pocket PC- oder Smartphone-SDK-Dokumentation.
So können Sie den Namen der CAB-Datei ändern und Authentifizierung hinzufügen
Klicken Sie im Projektmappen-Explorer mit der rechten Maustaste auf CABProject, und klicken Sie dann auf Eigenschaften.
Das Dialogfeld CABProject-Eigenschaftenseiten wird angezeigt. Ändern Sie im Feld Ausgabedateiname den Namen der CAB-Datei und des Pfads in Debug\CABProject.cab, und klicken Sie dann auf OK.
Sie können diese Eigenschaftenseite auch verwenden, um dem Projekt Authentifizierung hinzuzufügen. Die Authentifizierung ist für Smartphone-Projektmappen erforderlich. Sie wird nicht in Pocket PC-Projektmappen unterstützt, die auf Windows Mobile 2003 SE oder früheren Versionen basieren. Weitere Informationen hierzu finden Sie unter Sicherheit bei Geräteprojekten.
So fügen Sie die Geräteprojektanwendung dem CAB-Projekt hinzu
Klicken Sie im Dateisystem-Editor im linken Bereich auf Anwendungsordner, um anzugeben, dass die Dateien, die Sie in den folgenden Schritten auswählen, in diesem Ordner auf dem Zielgerät installiert werden sollen.
Falls der Dateisystem-Editor nicht sichtbar ist, klicken Sie im Projektmappen-Explorer mit der rechten Maustaste auf den Namen des CAB-Projekts und klicken auf Ansicht und dann auf Dateisystem.
Zeigen Sie in Visual Studio im Menü Projekt auf Hinzufügen, und klicken Sie dann auf Projektausgabe.
Wählen Sie im Dialogfeld Projektausgabegruppe hinzufügen aus der Dropdownliste Projekt Ihr Projekt für intelligente Geräte aus.
Wählen Sie in der Ausgabenliste Primäre Ausgabe aus, und klicken Sie auf OK.
| Hinweis: |
|---|
Wenn Sie ein CAB-Projekt für intelligente Geräte für eine Anwendung erstellen, die in C++ geschrieben wurde, müssen Sie dem CAB-Projekt Abhängigkeiten wie atl90.dll, mfc90U.dll und/oder msvcr.dll manuell hinzufügen, wenn Sie einen dynamischen Link zu diesen DLLs erstellen. Es wird jedoch dringend empfohlen, den statischen Link zu verwenden, um die Abhängigkeiten für MFC-/ATL-DLLs zu reduzieren. Bei dem statischen Link sollten die DLLs nicht zusammen mit der Anwendung verteilt werden. Wenn Sie den dynamischen Link verwenden und die DLLs in der CAB verteilt werden müssen, sollten Sie die DLLs auf dem Gerät nicht im Systemverzeichnis, z. B. \Windows, installieren. Installieren Sie die DLLs stattdessen im Verzeichnis der lokalen Anwendung. Wenn Sie eine komplette Anwendungssuite verteilen, in der alle Anwendungen die ATL-/MFC-Laufzeitbibliotheken dynamisch einbinden, installieren Sie alle Anwendungen und die Laufzeit-DLLs in einem Anwendungsverzeichnis und erstellen Verknüpfungen zu den Anwendungen, die in separaten Ordnern abgelegt werden können. Damit wird Platz gespart und gleichzeitig verhindert, dass die DLLs im Systemverzeichnis später ersetzt werden, wodurch Anwendungen, die diese DLLs einbinden, unbrauchbar würden. |
So fügen Sie dem CAB-Projekt Abhängigkeiten hinzu (nur C++-Projekte)
Klicken Sie im Projektmappen-Explorer mit der rechten Maustaste auf den CAB-Projektnamen, zeigen Sie auf Hinzufügen, und klicken Sie auf Datei.
Navigieren Sie zu Visual Studio-Installationsordner\VC\ce\dll\Plattform.
Wählen Sie die hinzuzufügenden Dateien aus.
Drücken Sie bei einem MFC-Projekt die STRG-TASTE, und klicken Sie auf MFC90U.DLL, atl90.dll und msvcr90.dll. Falls für die Anwendung sprachspezifische MFC-Dateien erforderlich sind, müssen Sie möglicherweise auch auf mindestens eine der sprachspezifischen DLLs klicken.
Drücken Sie bei einem ATL-Projekt STRG, und klicken Sie auf atl90.dll und msvcr90.dll. Wenn die ATL-Projektmappe MFC unterstützt, klicken Sie auch auf MFC90U.DLL.
Klicken Sie bei einem Win32-Projekt auf msvcr90.dll.
Klicken Sie im Dialogfeld Dateien hinzufügen auf Öffnen, um die Dateien dem CAB-Projekt hinzuzufügen.
Klicken Sie im Dateisystem-Editor im linken Bereich mit der rechten Maustaste auf DateisystemaufZielcomputer.
Zeigen Sie auf Speziellen Ordner hinzufügen, und klicken Sie dann auf Windows-Ordner.
Klicken Sie im linken Bereich von Dateisystem-Editor auf den Ordner, der die primäre Ausgabe enthält. Die DLLs wurden standardmäßig demselben Ordner hinzugefügt wie die primäre Ausgabe. Um sie in den Windows-Ordner zu verschieben, wählen Sie die Dateien im Dateisystem-Editor im mittleren Bereich aus und ziehen sie über das Symbol Windows-Ordner.
Gehen Sie ebenso vor, um weitere Abhängigkeiten hinzuzufügen, die für die Projektmappe erforderlich sind. Abhängigkeiten können einem beliebigen Ordner hinzugefügt werden und nicht unbedingt dem Windows-Ordner.
So erstellen Sie eine Verknüpfung zur Geräteprojektanwendung
Wählen Sie im Dateisystem-Editor im rechten Bereich Primäre Ausgabe von <Anwendungsprojektname> aus.
Klicken Sie im Menü Aktion auf Verknüpfung erstellen zu Primäre Ausgabe von <Anwendungsprojektname>.
Dieser Befehl fügt unter dem Ausgabeelement ein Verknüpfungselement hinzu.
Klicken Sie mit der rechten Maustaste auf das Verknüpfungselement, klicken Sie auf Umbenennen, und geben Sie der Verknüpfung einen passenden Namen.
So verschieben Sie die Verknüpfung in das Startmenü oder den Programmordner
Klicken Sie im linken Bereich des Dateisystem-Editors mit der rechten Maustaste auf Dateisystem auf Zielcomputer, zeigen Sie auf Speziellen Ordner hinzufügen, und klicken Sie auf Startmenüordner oder Programmordner.
Ziehen Sie die Verknüpfung vom Anwendungsordner in den Startmenüordner oder Programmordner.
So fügen Sie einen Registrierungseintrag hinzu
Klicken Sie im Projektmappen-Explorer auf das CAB-Projekt.
Zeigen Sie im Menü Ansicht auf Editor, und klicken Sie anschließend auf Registrierung.
Klicken Sie im Registrierungs-Editor mit der rechten Maustaste auf HKEY_CURRENT_USER, und klicken Sie dann auf Neuer Schlüssel.
Benennen Sie den Eintrag Neuer Schlüssel im Registrierungs-Editor in SOFTWARE um.
Klicken Sie mit der rechten Maustaste auf den neuen Schlüssel, zeigen Sie auf Neu, und klicken Sie dann auf Schlüssel.
Benennen Sie den Eintrag Neuer Schlüssel im Registrierungs-Editor in MyCompany um.
Klicken Sie mit der rechten Maustaste auf den Eintrag MyCompany, und klicken Sie dann auf Eigenschaftenfenster.
Der Wert im Feld Name wurde in MyCompany geändert.
Erstellen und Bereitstellen der CAB-Datei
So erstellen Sie die CAB-Datei
Klicken Sie im Menü Erstellen auf CABProject erstellen.
- oder -
Klicken Sie im Projektmappen-Explorer mit der rechten Maustaste auf CABProject, und klicken Sie dann auf Erstellen.
Klicken Sie im Menü Datei auf Alle speichern.
CAB-Dateien für Smartphone-Projektmappen müssen digital signiert werden, bevor sie für das Gerät eines Endbenutzers bereitgestellt werden können. Digitale Signaturen werden für Pocket PC-Projektmappen auf Grundlage von Windows Mobile 2003 SE und früherer Versionen nicht unterstützt. Weitere Informationen hierzu finden Sie unter Gewusst wie: Signieren einer CAB-Datei (Geräte).
So stellen Sie die CAB-Datei für das Gerät bereit
Navigieren Sie in Windows Explorer zu dem Ordner, in dem die Projektmappe gespeichert ist. Die CAB-Datei befindet sich im Ordner CABProject\Release der Projektmappe.
Kopieren Sie die CAB-Datei auf ein Gerät, das über ActiveSync 4.0 oder höher angeschlossen ist.
Wenn ein Benutzer auf dem Gerät im Datei-Explorer auf den Namen der CAB-Datei tippt, extrahiert Windows CE die CAB-Datei und installiert die Anwendung auf dem Gerät.
Weitere Informationen finden Sie in der Smartphone- und der Pocket PC-SDK-Dokumentation.
Siehe auch
Referenz
Verpacken (Vorgehensweise für intelligente Geräte)