Citra to nowy, eksperymentalny emulator konsoli Nintendo 3DS napisany w języku C++. Na stan dzisiejszy jest w stanie emulować kilka(naście) tytułów na w miarę przyzwoitym poziomie. W chwili obecnej możemy pograć sobie w takie hiciory jak The Legend of Zelda: Ocarina of Time oraz Animal Crossing, jednak większość gier (o ile się w ogóle uruchomi…) działa zazwyczaj wolno i nierzadko zdarzają się glitche w wyświetlanej grafice. Aplikacja jest dynamicznie rozwijana i wciąż zyskuje na popularności zatem warto się niż już teraz zainteresować.
Skąd pobrać emulator ?
Jak wspomniałem apka jest wciąż rozwijana i co kilka dni zostają wypuszczane nowe wersje. Emulator wydany jest na licencji GPLv2 więc każdy z nas ( o ile ma trochę oleju w głowie) może legalnie i zupełnie za darmo pobrać pliki źródłowe do kompilacji. Co prawda w sieci jest wiele źródeł z których możemy pobrać gotowe binarki, jednak 100% pewność posiadania najnowszej kompilacji będziemy mieli tylko wtedy, gdy sami go sobie zrobimy 😉
Tylko trzeba wiedzieć jak się za to zabrać i tym się właśnie zajmiemy w tym poradniku.
Przygotowanie do kompilacji.
Aby skompilować program pod systemem Windows musimy pobrać następujące aplikacje:
Visual Studio Community – w trakcie instalacji upewnijmy się, że mamy zaznaczone poniższe funkcje VS:
Instalacja pakietu Visual Studio zajmie chwilę.
msysgit – w trakcie instalacji zaznaczamy opcję
Aby korzystać z git-a z poziomu wiersza poleceń.
Cmake – pobieramy najnowszą dostępną wersję 64 bitową dla naszego systemu.
Qt – Citra wywala błędy podczas kompilacji dla Qt w wersji niższej niż 5.3.x zatem wybieramy nowsze wydania.
Kompilujemy program.
Teraz najtrudniejsze – czyli budujemy sobie *.exe od podstaw.
W pierwszej kolejności uruchamiamy wiersz poleceń w którym wydajemy następującą komendę:
git clone --recursive https://github.com/citra-emu/citra.git
Spowoduje to pobranie repozytorium na nasz dysk.
Zwrócicie uwagę, gdzie msysgit pobierze wam te pliki. W moim przypadku zrobił to do folderu /system32/ co powodowało błędy kompilacji. Jeżeli i w Waszym przypadku będzie tak samo to wytnijcie folder Citra w inne miejsce (np. na pulpit)
Uruchamiamy aplikację CMake w której wybieramy folder zawierający pliki z git’a (1), oraz folder na pliki które utworzy CMake (2)
Po wduszeniu przycisku Configure (3) wybieramy generator naszego projektu:
W tym kroku koniecznie wybieramy Visual Studio 14 2015 Win64. Wybranie innego generatora spowoduje problemy w dalszej części tego poradnika. Po naciśnięciu Finish generator rozpocznie swoją pracę jednak na 100% nie ominą nas błędy. Pierwszy z nich naprawimy stawiając “ptaszki” przy następujących pozycjach:
Po wciśnięciu Configure po chwili generator upomni się o biblioteki Qt:
Ponownie naciskamy na Configure modląc się, żeby aplikacja nie sprawiła nam więcej kłopotów. Gdy log aplikacji wyświetli nam informację:
Configuring done
Naciskamy przycisk Generate aby stworzyć citra.sln potrzebny nam w kolejnym kroku. Uff, Najgorsze mamy za sobą 😉
Otwieramy go zatem w aplikacji Visual Studio. Tutaj po prawej stronie odnajdujemy projekt citra-qt. Klikamy na nim PPM i wybieramy set as StartUP Project…, a następnie Rebulid.
To samo robimy dla projektu citra.
Gotowa aplikacja zostanie stworzone w folderze
\bin\Debug\
Ostatnim krokiem jest skopiowanie biblioteki qwindows.dll, jeżeli instalowaliście Qt w domyślnym miejscu ten plik znajduje się w fodlerze:
C:\Qt\[X.X]\msvc2015_64\plugins\platforms
Gdzie pod [X.X] podstawcie wersję zainstalowanego Qt w Waszym systemie.
Uruchamiamy gotową aplikację – w chwili GUI programu nie powala:
Oraz nie posiada niemal żadnych opcji konfiguracyjnych – jeżeli to się zmieni z pewnością napiszemy 😉