Bài 3: Hướng dẫn cài đặt Cocos2d - x V3.x trên Window theo từng bước, 100% Working

Trong bài 3 này mình sẽ hướng dẫn cụ thể các bạn cách cài đặt Engine Cocos2d - x V3.0 RC0 phiên bản mới nhất trên nền Window 7, vì máy mình chỉ có Win 7 thôi. Lưu ý Engine này không dùng với XP nhé. Phiên bản mới nhất tính đến thời điểm sửa bài là 3.2 RC0 ( các bạn chỉ nên sử dụng các phiên bản 0 có mã đằng sau, hoặc có mã RC.x mà ko nên xài các mã Alpha.x, Beta.x nhé). Giờ đã lên 3.3( tháng 12/2014 )

Việc cài đặt Engine này thật sự là khá phức tạp với nhiều người, bởi nó không đơn giản chỉ là chạy file setup.exe, rồi Next, Next, finish. Nó đòi hỏi phải cấu hình hệ thống, cài đặt các thành phần bổ trợ cho nó thì mới có thể chạy được. Và việc chạy nó cũng phải thông qua 1 chương trình Editor (Visual Studio chẳng hạn). Sẽ có bạn thắc mắc sao người phát triển ko làm kiểu file chạy Setup nhỉ? Hoàn toàn làm được nhưng khi đó bộ cài sẽ vài GB hoặc hàng chục GB do tích hợp vào trong nó hàng tá thứ khác ( như Android SDK, NDK, JDK, ...).

Trước đây mình cũng chỉ định cài bản 2.2.3 thôi vì có nhiều tài liệu hướng dẫn trên mạng, nhưng mình khuyên các bạn nên dùng bản mới nhất V3.0, vì bản cũ nêu trên đã lạc hậu cách đây hơn 1 năm rồi. Bản mới có rất nhiều cải tiến hay ho, do đó việc cài đặt cũng phức tạp không kém vì các lệnh , các thiết lập hầu như đổi mới hết. Thôi bắt đầu ngay nào.

1 Điều này mình phải nói trước để các bạn thông cảm là, hệ thống của mình chỉ có Win 7 - 32 bít, Ram 2G ( và 4G - máy công ty) nên nếu các bạn có hệ thống khác như Win 7-64, Win8, MacOS, Linux chỉ đọc tham khảo và cố gắng thử trên máy của các bạn, cách cài cũng gần tương tự thôi, chỉ khác dòng lệnh với từng hệ thống. Chắc vậy

Win7-64, Win8 Các thể loại cài Engine này không vấn đề gì nhé, Cách cài đặt cho phiên bản 3.x là như nhau, được trình bày ở bên dưới. Không dùng cho các bản Alpha, Beta ( Sửa ngày 7..11.14 )

(Sửa ngày 20/12/2014 - Cài đặt cho bản Cocos2d-x 3.3 Final)

* Chuẩn bị nguyên liệu, chú ý down đúng phiên bản cho máy 32 bít hoặc 64 bít

1) Bộ code Cocos2d-x ( không phải bản JS ) V3.0 ( 3.x -Đang max 3.3 - tháng 12/2014 ) FINAL  http://www.cocos2d-x.org/download.

2) Nền tảng Android ( để build apk file cho Android ) :

- ADT + miễn phí Eclipse:

http://developer.android.com/tools/sdk/eclipse-adt.html

Thời điểm hiện tại, Google ko tích hợp bộ SDK cùng Eclipse nữa, bạn phải down Android Studio về cài nhé, trong đó tích hợp SDK, link down đây

http://developer.android.com/sdk/index.html

Dùng bộ Android Studio của GG thì khỏi nói rồi, ai không thích thì cứ dùng Eclipse + Plugin ADT thôi.

- NDK9: https://developer.android.com/tools/sdk/ndk/index.html

* Lưu ý 1 chút, theo link trên thì không còn cho down bản 9, mà chỉ có bản 10, chia 2 platform 32, 64. ( ko nhớ là bản 9 có chia ra thế ko)
Cocos mới nhất 3.2 vẫn chỉ xài r9d trở xuống nhé, bản r10 bị lỗi khi build Android, mọi người chú ý, tìm trên mạng bản r9d-win86_64 mà download Ví dụ http://dl.google.com/android/ndk/android-ndk-r9d-windows-x86_64.zip

- Chú ý: Bản engine 3.3 update lên NDK10 nhé, fix cho Android 5 thì phải

- NDK 10 :http://developer.android.com/tools/sdk/ndk/index.html

- JDK7: ( có bản 8 nhưng mình vẫn xài 7.1), Ai xài 8 thì xài

http://www.oracle.com/technetwork/java/javase/downloads/index-jsp-138363.html

3) ANT 1.9.3 http://ant.apache.org/bindownload.cgi

4) Python 2.7.6 ( không xài 3.4 ): https://www.python.org/download/

5) Visual Studio 2012 ( Khuyên dùng ) - bạn tìm link mạng nhé + Visual Assist X10.8 http://www.vn-zoom.com/f103/red-face-visual-assist-x-10-8-2001-0-ci-hien-thi-cac-ham-cac-bien-cac-doan-chuong-trinh-mot-cach-ro-rang-2829579.html

Visual Assist X10.8 là Plugin để Auto complete code cực hay của Visual. Khuyên dùng sau thời gian học khoảng 1-2 tháng nhé.

* Lưu ý là:

- Bản mới V3.0 - 3.x không cần cài Cygwin như các bản cũ
- Các thành phần JDK, SDK,... Bạn phải down đúng phiên bản 32 bít, 64 bít tương ứng hệ điều hành của mình, trường hợp nào chỉ có 1 phiên bản ( ko ghi gì cả ) thì bạn vẫn cài đặt được cho cả 2 hệ thống 32, 64 (ví dụ ANT, Python)

Bạn làm theo các bước sau đây, đảm bảo cài đặt thành công, vì mình đã làm đi làm lại trên 2 máy mất gần 1 tuần mới thành công, rút ra kinh nghiệm cho mọi người.

Bước 1: Cài đặt JDK, Python như 1à soft thông thường

+ JDK: Cài như soft, nó sẽ tự tạo ra 1 biến trong System Environment,

JAVA_HOME = D:\Program Files\Java\jdk1.7.0_51

Nếu chẳng may xóa mất, bạn phải add lại  = tay

JDK 7, 8 đều OK. Ko nên xài JDK 6

Cài Python 2.7.5 như 1 Soft thông thường, nó sẽ cài vào D:\Python27 hoặc C:\Python27. mặc định window mình cài vào ổ D mà, hix.

Bước 2: Cài NDK, ADT, ANT, Cocos2d-x V3.0 Final - V3.x

NDK, ADT, ANT, Cocos2d-x V3.0 - 3.x thì chỉ việc giải nén vào trong thư mục như thế này

 + ANT:     Q:Android/ANT
 + SDK:     Q:Android/SDK
 + NDK:    Q:Android/NDK
 + Cocos2dx3 : Q:Android/Cocos2dx3

+ Với Android Studio, bạn cài như soft bình thường, rồi tìm đường dẫn của SDK nhé

Chạy file SDK.exe trong Q:\ANDROID\SDK, để cài đặt các bộ SDK của Android lên máy, chú ý là phải cài bản Android 2.3.3 - API 10 là bắt buộc nhé, còn đâu cài thêm bao nhiêu tùy bạn. 
Trên máy 64 bít buộc phải chạy Eclipse để chạy SDK Manager nha

Lưu ý là khi bạn giải nén ra thư mục, tên nó sẽ dài loằng ngoằng, bạn nên đặt gọn lại như trên để dễ quản lý.
Xong phần này

Bước 3: Thiết lập System Varialbe, RẤT QUAN TRỌNG, 

- Chuột phải Mycomputer/Properties/Advanced System setting/Environment Variables, ta có bảng nhỏ sau

Bạn để ý ở bảng Environment Variables có 2 ô, ô trên dành cho User đang dùng máy, và ô dưới là của System.

Bạn lần lượt thêm vào các biến môi trường sau. Trong này mình có 2 ổ đĩa là D (ổ win) và Q ( chứa data) bạn cần chú ý để thay thế tên ổ đĩa tương ứng trên máy mình.

Ở phần User, thêm vào các biến sau , Click vào nút New bên trên

ANDROID_SDK_ROOT = Q:\ANDROID\SDK\sdk

COCOS_CONSOLE_ROOT = Q:\ANDROID\Cocos2dx3\tools\cocos2d-console\bin;

Path = Q:\android\cocos2dx3\tools\cocos2d-console\bin;

* Lưu ý COCOS_CONSOLE_ROOT , Path  sẽ được tạo ra khi bạn chạy setup.py ( Bước 6)

Ở phần System, thêm vào các biến sau. Click vào nút New bên dưới

ANT_HOME = Q:\ANDROID\ANT

ANT_ROOT = Q:\ANDROID\ANT\bin

NDK_ROOT = Q:\ANDROID\NDK

Path = D:\Python27;D:\Python27\Python.exe;Q:\ANDROID\SDK\sdk\platform-tools;%path%;%ANT_HOME%/bin;

Bổ sung thêm biến này nhé (mới phát hiện)

CLASSPATH = .;D:\Program Files\Java\jre6\lib\ext\QTJava.zip. ( có thể là JRE7, hoặc JRE8 tùy bản cài, có dấu "phẩy và chấm phẩy" ở đầu path nhé)

Với JDK 6 khi cài vào sẽ tự có, còn đối với các bạn cài JDK 7, 8 lần đầu thì phải thêm biến CLASSPATH này vào mới Build Android được.

* Lưu ý: Các biến Path, JAVA_HOME, thường là đã có sẵn, bạn chỉ việc bổ sung thêm vào biến Path đoạn trên cho phù hợp.

* Các giá trị của biến môi trường trên, không được có khoảng trắng ở đầu hoặc cuối, sẽ báo lỗi khi biên dịch

Bước 4: Test lại lần nữa

Chạy cmd, gõ vào lệnh

>java
 Nếu 1 đống sổ ra => JDK OK

 >ant --v
 1 đống sổ ra => ANT OK

 >adb
 1 đống => SDK OK

 >python
 hiện phiên bản => Python OK

Bước 5: Cài đặt Visual Studio 2012 và Visual Assist X 10.8 (KHUYÊN DÙNG)

- Cài và crack bình thường theo hướng dẫn trên mạng nhé các bạn nhé, cái này phục vụ cho việc code trên window, ai dùng Eclipse cũng ko sao, nhưng nghe nói là sắp tới ít hỗ trợ Eclipse, do Eclipse có lỗi quản lý gì đó.

- Để build trên window, bạn buộc phải cài VS 2012 nhé ( bản 2013 hơi khó cài với máy nào chưa có EXplorer 10 - hay 11 nhỉ, ko nhớ nữa). Khuyên dùng VS2012 Pro trở lên, mình xài Ultimate. Nhiều người xài VS 2013 cũng OK nhé

Bước 6: Chạy thử

Dùng CMD của Window (khuyên dùng)

D>q:
Q>cd android/cocos2dx3
Q/android/cocos2dx>setup.py

Nếu hiện bảng sau thì đã thành công 99%

Tắt cmd đi

Bật trở lại, Chúng ta bắt đầu SỬ DỤNG Cocos2dx V3.0 Final

Tạo 1 project mới

>cocos new hello -p com.vn.hello -l cpp -d q:/android/project

hoặc

>cocos new hello -l cpp -d q:/android/project

chạy cũng mất gần 5 phút nhé.

Đã xong, chạy thử nào

>cocos run -s q:android/project/hello -p win32

file build ra nằm trong q:android/project/hello/bin ( 3.0 ) ,  q:android/project/hello/publish (>3.1 )

bạn phải có Visual Studio 2012 cài sẵn thì mới dùng lệnh trên được
Lần build đầu tiên mất 5 -8 phút tùy máy , còn những lần sau, chỉ sửa code thì build nhanh thôi

Build cho Android nào, Nếu bạn đã cài SDK ( phải có android 2.3.3 - API 10) thì sẽ thành công thôi

>cocos compile -s q:/android/project/hello -p android --ap 16

hoặc như bên dưới, nó sẽ tự cài vào máy ảo
>cocos run-s q:/android/project/hello -p android --ap 16

Vào Q:\ANDROID\Project\hello\proj.android\bin\debug\android  (hoặc thư mục publish ), chạy file hello-debug.apk bằng máy ảo

>adb install Q:/ANDROID/Project/hello/proj.android/bin/debug/android/hello-debug.apk

hoặc cài trực tiếp vào máy điện thoại thật để test nhé

Vậy là đã Cài đặt thành công Cocos2d - x V3.0 Final - 3.x trên Window

P/S:

Các lệnh mới trên Cocos2d - x V3.0 FINAL - 3.x  (chạy bằng cmd của Window)

Tạo Project mới
cocos new NewProject -p com.vn.NewProject -l cpp -d Q:/android/myproject
(gõ cocos new -h để được help)

Biên dịch chương trình
Cho Android
cocos compile -s Q:/android/myproject/NewProject -p android --ap 16

Cho Window
cocos compile -s Q:/android/myproject/NewProject -p win32

(gõ cocos compile -h để được help)

Chạy chương trình

cocos run -s Q:/android/myproject/NewProject -p win32
cocos run -s Q:/android/myproject/NewProject -p android --ap 16

(gõ cocos run  -h để được help)

MỘT SỐ LƯU Ý KHÁC

Không build được với WIN32 

- Là do trước đó từng cài VS 2010 rùi xóa đi, nhưng vẫn còn trong registry của 64bit. Các bạn nào xài win 64bit bị lỗi này thì uninstall vs2010 rùi vào regedit và vào đây: HKEY_LOCAL_MACHINE\SOFTWARE\Microsoft xóa cái VisualStudio đi nhé, tiếp theo vào đây: HKEY_LOCAL_MACHINE\SOFTWARE\Wow6432Node\Microsoft tìm VisualStudio và xóa luôn, sau đó cài vs2012 hoặc vs2013 rồi run cocos lại là xong ^^

(Thanks to Dev Bananaer)

- Không build được Android: 

Bạn cd tới thẳng project của mình rồi dùng lệnh sau để chạy

cocos run -p android -j 4

Đã xong 1 bài rất dài, Nếu các bạn làm theo các bước trên ( Đặc biệt là bước 3) đảm bảo thành công.
nếu bạn nào ko thành công, cứ comment vào đây, mình giúp cho.

Chú ý: mình đã thử cài trên Win 7 64 bít ( do ham hố mới nâng Ram lên 4G), khi cài đặt chú ý down đúng các bản (JDK, NKD.vvv) hỗ trợ win 64 bít, cài như trên là OK. Nhiều bạn cài trên Win8 all cũng OK

+ Chỉ cẩn chú ý 1 điều là, các Project đã build trên Win32 ( chứa trong thư mục cũ ) khi cài win 64 vào không thể build lại được nhé. Nghĩa là bạn ko vác nguyên cái Project từ máy 32 sang máy 64 để build được ( chỉ tính build ra EXE, ko tính APK )

Giải pháp: Chúng ta chỉ việc giữ lại Classes và Resource sau đó tạo mới 1 project, copy lại Classes và Resource + Import các thư viện dùng thêm trong Project vào và build lại trên win 64 là ok. Đã test và thành công

+ Mỗi khi update lên phiên bản Engine version mới, bạn vẫn có thể build được những Project tạo ra bởi Engine version cũ ( Sẽ có lỗi xảy ra nếu version mới sửa đổi lại thư viện hàm ). Khi đó bạn phải cập nhật lại code của mình

+ Ngược lại khi bạn down Engine từ version mới về version cũ hơn ( nghĩ là ổn định hơn ) thì điều trên cũng có thể sẽ xảy ra ( và project lớn sẽ thường xảy ra ) cũng do sự khác nhau về thư viện hàm trong 2 phiên bản. Khi đó bạn cũng phải cập nhật code của mình về đúng cú pháp của phiên bản đó.

=> Tránh thay đổi Version khi chưa hoàn thành 1 Project bạn nhé.

(Đã có Video hướng dẫn ở đây nhé, Và nhớ bổ sung biến CLASSPATH )

(Sửa ngày 20.12.2014)

Bài 4: Chương trình đầu tiên "Hello World"