Erfahren Sie & Spielentwicklung des Masters Cocos2D

Aufrüstung des Cocos2d-I-Phones ist ein wiederkehrendes Problem für viele Entwickler, aber da es so selten während des Lebenszyklus eines Projektes geschieht, gibt es gerade keine Routine, um zu folgen. Schließlich könnten Sie Cocos2d-I-Phone befördern wollen, so entsteht die Frage: guten Tag das mit kleinstem Betrag von Schwierigkeiten? how do you do that with the least amount of trouble?

Da ich den Prozess durchgehe, mehr als 70 (!) Xcode-Projekte für die zweite Revision von meinem zu aktualisieren, Erfährst Cocos2D-Buch, dachte ich, dass ich die Schritte entwerfen sollte, einen vorhandenen Xcode 3 Projekt zu befördern, das Cocos2d-I-Phone v0.99.x zu einem Xcode 4 Projekt verwendet, das Cocos2d-I-Phone v1.0.x verwendet.

Offensichtlich wollen Sie die letzte Cocos2d-I-Phone-Version herunterladen und sie zu jedem Verzeichnis aufmachen. Erinnern Sie sich gerade, wo Sie es aufmachten, weil es ist, wovon Sie die neuen Bibliotheksmappen kopieren werden.

Sie wollen auch sicherstellen, dass Sie zu Xcode 4 inzwischen befördert haben, indem Sie das EIN/AUSGABE-STEUERSYSTEM 4.3 (oder später) SDK installieren, wenn Sie so bereits nicht getan haben.

Verwarnung: Stellen Sie Sicher, dass Xcode während der ersten Schritte geschlossen wird.

In der Mappe Ihres Projektes, in diesem Fall DoodleDrop03, wählen alle Mappen in aus befreit Mappe, und löschen Sie sie ohne Gnade:

Sie werden mit einem leeren enden befreit Mappe. Löschen Sie mit anderen Worten nicht befreit Mappe selbst, oder im Falle dass Sie taten, stellen Sie sicher, dass Sie erfrischen, befreit Mappe.

Verwarnung: Der Grund, warum ich alle Bibliotheken in lösche, befreit Mappe, anstatt einfach überzuschreiben, die Bibliotheken mit neuen ist einfach: Sie können annehmen, dass die aktualisierte Cocos2d-I-Phone-Version entfernt oder einige Dateien umbenannt hat. Durch das erste Löschen aller Bibliotheken können Sie überzeugt sein, dass keine "Zombie-Dateien" bestehen, die nicht mehr verwendet werden, aber noch kompiliert werden könnten, wenn Sie später die Bibliotheken wiederhinzufügen. Solche Zombie-Dateien würden den bauen Prozess schrauben und Fehler wie "Definierte Symbole des Duplikates" und andere solche Missgeschicke erzeugen. you can expect the updated cocos2d-iphone version to have removed or renamed some files. By first deleting all libraries you can be sure that no “zombie files” exist which are no longer used but might still be compiled when you later re-add the libraries. Such zombie files would screw up the build process and generate errors like “Duplicate defined symbols” and other such mishaps.

Das erste Ding, das Sie bemerken werden, wenn Sie das Befreien befördern wollen (Box2D, Backenhörnchen, cocos2d, CocosDenshion, cocoslive, FontLabel und TouchJSON) besteht darin, dass sie in verschiedenen Mappen im Cocos2d-I-Phone-Projekt sind, dass Sie heruntergeladen und aufgegangen haben.

Stellen Sie sicher, dass Sie genau die gleichen Mappen auswählen, die im Screenshot unten ausgewählt werden:

Dieser Unterschied im Mappe-Lay-Out kann ein bisschen verwirrend sein. Wessen Sie bewusst sein müssen, ist, dass der Box2D, das Backenhörnchen, FontLabel und die TouchJSON Mappen in der Außenmappe im Cocos2d-I-Phone-Projekt sind. Außerdem ist die Box2D Mappe, die Sie kopieren sollten, eine Submappe von Box2d. Bemerken Sie den Unterschied in der Kapitalisierung des Briefs D. Sie wollen die Mappe mit der Großschrift D kopieren: Box2D. Dasselbe geht für die CocosDenshion Mappe, Sie sollten die CocosDenshion Mappe innerhalb der CocosDenshion Mappe auswählen. Furthermore, the Box2D folder that you should copy is a subfolder of Box2d. Note the difference in capitalization of the letter D. You want to copy the folder with the uppercase D: Box2D. The same goes for the CocosDenshion folder, you should select the CocosDenshion folder inside the CocosDenshion folder.

Verwarnung: Stellen Sie Sicher, dass Sie die Box2D Prüfstand-Mappe nicht auswählen - wenn Sie tun und das ebenso kopieren, könnte Xcode 4 das Bauen des Projektes abschließen, das Verbrauchen der 100-%-Zentraleinheitsmacht und Verlangen einer Kraft verlassen, es zu schließen.

Bemerken Sie: Wenn Sie nur Backenhörnchen oder Box2D Physik, oder keinen von ihnen verwenden, können Sie das Kopieren dieser Mappen natürlich auslassen.

Um die Kopie opertation zu vollenden, gehen Sie zu befreit Mappe, und kleben Sie die kopierten Bibliotheksmappen auf, so dass Sie mit enden, befreit Mappe, die genau dem Image im Schritt #1 ähnlich ist.

Tipp: Wenn Sie Schinderei und Fall bevorzugen, können Sie gerade schleifen die ausgewählten Mappen von einem Fenster Finder bis einen anderen auf Ihr Projekt befreit Mappe. Das kann leichter sein zu tun, aber Sie sollten sich merken, den Auswahl-Schlüssel zu unterdrücken, indem Sie fallen, so dass Sie wirklich die Mappen kopieren, anstatt sie zu bewegen. Die Kopie-Operation wird durch das Grün + Ikone unter dem Cursor angezeigt, wie Sie & Fall schleifen, indem Sie den Auswahl-Schlüssel halten. This may be easier to do but you should remember to hold down the Option key while dropping so that you actually copy the folders instead of moving them. The copy operation is indicated by the green + icon underneath the cursor as you drag & drop while holding the Option key.

Öffnen Sie Ihr Projekt in Xcode 4 jetzt.

Wählen Sie alle Gruppen unter der cocos2d Quellgruppe aus und schlagen Sie Rücktaste, um diese Gruppen zu löschen (oder richtiger Klick und zu wählen Löschen). Sie werden mit einem Dialog wie im Screenshot unten veranlasst.

Stellen Sie sicher, dass Sie die Verzug-Auswahl auswählen, Entfernen Verweisungen, um Nur zu vermeiden, die neuen Bibliotheksmappen zu löschen, die Sie gerade kopierten:

Sobald Sie die Bibliotheksgruppen entfernt haben, sollte die cocos2d Quellgruppe völlig leer sein. Sie wurden gerade alle alten Verweisungen los, sich selbst von irgendwelchen potenziellen Kompilationsfehlern rettend, die durch Verweisungen auf Dateien verursacht sind, die mehr nicht bestehen können.

Als nächstes wollen Sie Ihre Bibliotheksmappen wiederhinzufügen. Ausgesuchter und richtiger Klick die cocos2d Quellgruppe und ausgesucht Fügt Dateien zu "NameOfYourProject" … Hinzu:

Durchsuchen Sie ins Projekt befreit Mappe, und wählen Sie alle Bibliotheksmappen aus, die Sie in Ihrem Projekt brauchen.

Sie können bemerkt haben, dass mein Projekt keinen Physik-Motor verwendet, so entschied ich mich dafür, sie hier nicht hinzuzufügen. Wenn Sie wirklich Box2D in Ihrem Projekt verwenden, würden Sie auch Box2D natürlich auswählen wollen. Ebenfalls, wenn Sie Backenhörnchen verwenden. Likewise if you use Chipmunk.

Bemerken Sie: Während es nicht ein Problem ist hinzuzufügen, dass beide Physik-Motormappen, tuend so die Größe Ihres App vergrößern könnten.

Jetzt ist hier, wo Sie mit den Optionen sorgfältig sein müssen! Sie wollen sicherstellen, dass sie genau als im Screenshot unten gesetzt werden. Am wichtigsten, Dateien hinzufügend, wird Xcode im Verzug sein, um die Dateien zum Hauptziel des Projektes (in diesem Fall DoodleDrop) statt des cocos2d Bibliotheksziels hinzuzufügen. Most importantly, when adding files Xcode will default to add the files to the project’s main target (in this case DoodleDrop) instead of the cocos2d libraries target.

Stellen Sie sicher, dass nur das cocos2d Bibliotheksziel ausgewählt wird, um zu vermeiden, dass irgendwelcher Fehler baut:

Sie sollten jetzt versuchen und das Projekt bauen. Wenn Sie Glück haben, wird es keine Fehler geben, und Sie können mit Ihrer Arbeit fortsetzen.

Aber am wahrscheinlichsten, abhängig von der Kompliziertheit Ihres Projektes und den mit dem Cocos2d-I-Phone vorgenommenen Änderungen, können Sie befestigen müssen irgendwelcher baut Fehler, die vorkommen. Die meisten von ihnen werden wahrscheinlich durch Klassen verursacht, die umbenannt worden sind oder Funktionen, die missbilligt worden sind. In diesem Fall werden Sie durch die API-Verweisung herausfinden und Zeichen veröffentlichen müssen, was die Änderungen sind, und wie man sie befestigt. In this case you’ll have to find out through the API Reference and release notes what the changes are and how to fix them.

Ein allgemeines Problem, das spezifisch zu älteren Projekten vorkommt, ist der "fehlende Grund-SDK" Fehler. Ich denke, dass es die Xcode Version war, die mit Mac OS X Schnee-Leopard eingeführt ist (veröffentlicht am 28. Aug 2010), der schließlich dieses gefürchtete Problem befestigte hinzufügend, dass ein "letztes EIN/AUSGABE-STEUERSYSTEM" Auswahl für den Grund-SDK Einstellung Baut.

Wenn Sie eine Nachricht wie das sehen (besonders, wenn es Ihnen eine kompilieren Warnung oder Fehler gibt):

Sie sollten sich ändern die Grund-SDK Bauen Einstellung Ihres Projektes, das "Letzte EIN/AUSGABE-STEUERSYSTEM" Einstellung zu verwenden:

Bemerken Sie: In einigen Fällen kann es notwendig sein zu schließen Xcode 4 und es wiederzueröffnen, um den "fehlenden Grund-SDK" Nachricht zu machen, gehen weg.

Normalerweise erben alle Ziele in Xcode die Bauen Einstellungen des Projektes standardmäßig.

Jedoch, sobald Sie jede Änderung mit irgendwelchem vorgenommen haben, Bauen Einstellung am Zielniveau das Baut Einstellung wird nicht mehr erben mit demselben vorgenommene Änderungen Bauen Einstellung auf dem Projektniveau. Die Verzug-Reaktion durch viele Entwickler ist häufig, die Kugel zu beißen und die Bauen Einstellungen des Projektes sowie aller Ziele zu überprüfen und nachzuprüfen, und dieselbe Änderung ebenso oft vorzunehmen, wie Sie Ziele in Ihrem Projekt haben.

Tun Sie das nicht, es gibt einen besseren und leichteren Weg!

Sie können eine Bauen Einstellung am Zielniveau zum Verzug zurück haben, um die Bauen am Projektniveau definierte Einstellung zu erben. Ebenfalls kann eine Bauen Einstellung am Projektniveau veranlasst werden, von der OS Standardeinstellung zu erben. Im Screenshot unten habe ich die Bauen Einstellung am Zielniveau zweckmäßig geändert: In the screenshot below I have purposefully changed the Build Setting at the target level:

Um es zu haben, soll Verzug zurück zur Projekteinstellung, die Letztes EIN/AUSGABE-STEUERSYSTEM (EIN/AUSGABE-STEUERSYSTEM 4.3) alles ist, welch Sie tun müssen, auswählen, die Einstellung Bauen und die Löschtaste schlagen:

Tipp: Die Schaltung vom Vereinigten bis die Niveau-Ansicht, die Bauen Einstellungen nachprüfend, macht es leicht zu sehen, die Einstellungen Bauen, werden geerbt, und die nicht sind. Sie werden auch bemerken, dass irgendwelcher Einstellung Baut, die am gegenwärtigen Niveau geändert worden ist und nicht erbt, wird sein Wert mehr in kühnen Briefen gedruckt. You’ll also notice that any Build Setting that has been changed at the current level and doesn’t inherit its value anymore is printed in bold letters.

Das glückliche Codieren mit Ihrem kürzlich aktualisierten Cocos2d-I-Phone-Projekt! Dieser Steigungstutorenkurs wird auch in der zweiten Revision des Erfahrens des Cocos2D Buches gedruckt.

Tipp: Mit Kobold2D wird es noch leichter sein, Ihr Projekt zu befördern, weil eine einfache Kopie & Teig der Dateien in der kobold2d Mappe genügen werden. Wenn es jemals irgendwelche zusätzlichen Schritte gibt zu folgen, werden wir sie im Detail natürlich beschreiben. If there are ever any additional steps to follow we’ll describe them in detail of course.