PSDK3v3 - универсальная компиляция приложений для PSV, PSP, PS3 и Windows

[ErikPshat]

Компиляция приложений для PSV, PSP, PS3 и Windows
programming.png

Содержание инструкции:

• Часть 1. Как скачивать исходный код с GitHub?
• Часть 2. Установка компилятора PSDK3v3
• Часть 3. Компиляция с помощью Makefile
• Часть 4. Компиляция с помощью CMake

Здесь я постараюсь рассказать о компиляции готовых программ для PS Vita из исходного кода.
Исходный код или Source code - это набор текстовых файлов сырого кода и набор ресурсов, из которых потом с помощью компиляторов SDK компилируются программы. Некоторые разработчики прикладывают свои исходные коды в папке src вместе с готовой рабочей программой, а так же, заливают на репозитории, например, на популярный GitHub. Многие недалёкие в программировании юзеры даже не имеют представления, как оттуда скачать выложенный там исходный код. Поэтому, пожалуй, лучше именно с этого и начать.

Часть 1. Как скачивать исходный код с GitHub? Top-button.gif

Для скачивания с репозиториев существует множество различных программ. Я же расскажу про программу-черепашку TortoiseSVN.

1. Нажмите на картинку ниже, чтобы скачать программу под свою битность ОС и установите её:
   
   tortoisesvn.png или её аналог TortoiseGit.png
   
   
2. Ниже, на той же странице, вы можете скачать языковой файл перевода, так же, под битность своей ОС, и установить его.
   Сменить язык можно в меню настроек, нажав правой кнопкой на любой папке и, выбрав TortoiseSVN -> Settings.
   
   
3. Теперь давайте попробуем скачать с ГитХаба исходники VitaShell. Идём на главную страницу: https://github.com/TheOfficialFloW/VitaShell.
   
   
4. В левом верхнем углу страницы выделяем и копируем (CTRL+C) название репо - VitaShell
   
   VitaShell1.png
   
   
5. Создаём пустую папку в любом месте жёсткого диска под таким же названием, т.е просто вставляем в название создаваемой папки ранее скопированное название (CTRL+V). Конечно же, вы можете придумать любое своё название для папки.
   
   
6. Теперь сверху справа видим зелёную кнопочку Clone or download и нажимаем её, где раскрывается вот такое окошко:
   
   VitaShell2.png
   
   
7. Да, вы можете просто скачать архив с исходниками по ссылке "Download ZIP", но это не наш случай, поэтому, скопируйте ссылку из этого окошка, просто нажав на иконку справа.
   
   
8. Теперь, нажмите правой кнопкой на вашу созданную папку и выберите в контекстном меню "Checkout.png SVN Checkout..."
   
   SVN Checkout1.png
   
   
9. Откроется окно "Tortoise SVN" и ранее скопированная ссылка автоматически подхватится из буфера обмена и вставится в нужное поле (выдело синим):
   
   SVN Checkout2.png
   
   
10. Нажмите на кнопку OK и вы увидите процесс скачивания исходников в вашу папку:
    
    SVN Checkout3.png
    
    
11. Теперь, ваша папка с исходниками пометится такой зелёной галочкой:Checkmark.png. Это означает, что на данный момент исходники находятся в нетронутом состоянии. Как только вы внесёте изменения в какой-нибудь файл, как вы сразу увидите, что значёк папки и изменённого файла приобретут иконку с красным восклицательным знакомExclamation.png:
    
    SVN Checkout4.png
    
    
12. Теперь вы можете редактировать, удалять файлы исходников и в любой момент можете всё вернуть в исходное состояние, т.е. в любой момент обновить исходники до последней ревизии или до любой предыдущей ревизии, просто нажав на папку правой кнопкой и выбрав в контекстном меню пункт "SVN Update":
    
    SVN Checkout5.png
    
    Да, стоит заметить, что изменённые файлы не будут обновляться. Если вы захотите их тоже обновить, просто удалите их, тогда, при обновлении, автоматически скачаются оригиналы.
    
    
13. Ну вот и разобрались. Про остальные функции вы можете сами узнать, просмотрев из раскрывающегося списка в пункте "TortoiseSVN" всевозможные плюшечки, которые нам на данный момент пока не нужны.

Часть 2. Установка компилятора PSDK3v3 Top-button.gif

Для компиляции программ требуется SDK (Software Development Kit) — комплект средств разработки, который позволяет специалистам по программному обеспечению создавать приложения для компьютерной системы, игровых консолей, операционных систем и прочих платформ. Поэтому, в первую очередь, произведём установку SDK.

1. Идём в репозиторий zecoxao, где уже есть минимально подготовленная сборка VitaSDK с сопутствующими компонентами, под названием PSDK3v3:
   • PSDK3v3 MinGW - инструкция написана на основе данной сборки под 32-битную Windows.
   • PSDK3v3 msys64 - изменённая новая версия под 64-битную Windows
   Состав PSDK3v3

   Сборка основана на MinGW, MSIS и следующих инструментах и библиотеках:

   • curl [https://curl.haxx.se/]
   • vitasdk [https://github.com/vitasdk]
   • vita_portlibs [https://github.com/xerpi/vita_portlibs]
   • ftpvita [https://github.com/xerpi/libftpvita]
   • vita2d [https://github.com/xerpi/libvita2d]
   • psp2link [https://github.com/psxdev/psp2link]
   • debugnet [https://github.com/psxdev/debugnet]
2. Нажимаем справа зелёную кнопочку Clone or download и скачиваем ZIP-архив по ссылке "Download ZIP" куда-нибудь, например, на рабочий стол.
   
   
3. Открываем архив PSDK3v3-master.zip и видим внутри папочку с таким же названием "PSDK3v3-master". Извлекаем эту папочку в корень диска C:\ и никуда иначе!!!
   Примечание: дело в том, что этот комплект так же компилировался автором и все пути к вложенным файлам и папкам автоматически прописывались в файлы, создаваемые при компиляции. Поэтому, ничего трогать и изменять месторасположение категорически воспрещается.
   
   
4. Теперь, в корне диска C:\ переименовываем название извлечённой папки PSDK3v3-master на PSDK3v3. То есть, удаляем из названия лишний суффикс -master, который GitHub автоматически присваивает к вложениям.
   
   
5. Далее, проходим по пути C:\PSDK3v3\MinGW\msys\1.0 и запускаем файл msys.bat
   Вы увидите, что в папке "home" создалась ещё одна "домашняя папка" под названием вашего имени пользователя компьютера, а в открывшемся чёрном консольном окне вы увидите зелёными буквами данное имя. Это означает, что вы уже находитесь в своей "домашней папке" под вашим именем.
   
   
6. Введите в консольном окне cmd свою первую команду "exit", чтобы закрыть его. Нажмите правой кнопкой по msys.bat и сделайте Отправить -> Рабочий стол (создать ярлык), для быстрого доступа к консольному окну MinGW.
   
   
7. И в заключении, вам необходимо установить путь к компилятору в "Переменные среды" PATH, чтобы система могла распознавать команды к исполняемым файлам компилятора из любого окна консоли, например, из стандартного окна CMD Windows. Для этого:
   
   
   1. Пройдите в папку C:\PSDK3v3\MinGW\msys\1.0\postinstall и запустите батник pi.bat.
      
      
   2. На вопрос Do you wish to continue with the post install? [yn ] ответьте y и нажмите Enter.
      
      
   3. На вопрос Do you have MinGW installed? [yn ] ответьте y и нажмите Enter.
      
      
   4. На вопрос Where is your MinGW installation? введите путь C:/PSDK3v3/MinGW
      
      
   5. На последний вопрос ответьте y и нажмите Enter, затем ещё раз Enter для закрытия окна.
      
      
   6. После подобных внесений изменения в систему, компьютер следует перезагрузить.
   
   
   Дополнительная проверка:

   Вам необходимо проверить, прописались ли пути к папкам исполняемых файлов нового компилятора в переменную PATH.
   
   

   1. Нажмите сочетание клавиш Win + Pause/Break
      
      
   2. В открывшемся окне "Система" нажмите слева "Дополнительные параметры системы"
      
      
   3. В открывшемся окне "Свойства системы" нажмите в самом низу кнопку "Переменные среды..."
      
      
   4. Выделите строку PATH и нажмите кнопку "Изменить"
      
      
   5. Проверьте, прописаны ли там следующие пути, если нет, то впишите и поместите их на первое место, разделяя пути символом ; (точка с запятой):
      В Windows 10 каждый путь вписывается отдельно, без ; и с помощью кнопки "Вверх" переместите эти строчки на первое место в том же порядке.
      
      Это нужно для того, чтобы система находила и использовала именно эти компиляторы PSDK3v3 для PS Vita в первую очередь, т.к. у юзера могут быть установлены отдельно и другие компиляторы, например MinGW, Msys, Perl, PSPSDK, Python, QT и т.д, которые так же имеют в чистом виде или в своём составе MinGW и Msys, которые сконфигурированы по другому и ничего не знают о существовании PSDK3v3, от чего могут случаться ошибки при компиляции приложений для PS Vita.
      
      
      • C:\PSDK3v3\MinGW\msys\1.0\local\vitasdk\bin
      • C:\PSDK3v3\MinGW\msys\1.0\bin
      • C:\PSDK3v3\MinGW\bin

   
   Теперь, вам нет необходимости каждый раз пробираться к папке C:\PSDK3v3\MinGW\msys\1.0, чтобы запустить консоль через msys.bat или искать ярлык на рабочем столе, а затем продвигаться по папкам, вручную прописывая пути. Вы можете, находясь прямо в папке с исходниками, удерживая клавишу SHIFT, нажать правой кнопкой в пустом месте папки и Открыть окно команд в контекстном меню, и тут же ввести команду на компиляцию make. Система сама найдёт нужный компилятор и выполнит команду.
   
   Далее, в инструкции я не буду придерживаться данного метода (это между нами), а буду использовать классический способ через msys.bat, как указывал автор PSDK3v3.
   

На этом установку PSDK3v3 будем считать законченной.
Давайте попробуем скомпилировать свою первую программу с Makefile - Hello World для PS Vita ...






Часть 3. Компиляция с помощью Makefile Top-button.gif

Данная часть 3 инструкции применяется для исходников, в которых имеется файл Makefile.

1. Идём за исходниками в репозиторий: https://github.com/xerpi/vitahelloworld
   
   
2. Нажимаем там справа зелёную кнопочку Clone or download и копируем адрес репо, кликнув иконку напротив адресной строки.
   
   SVN Checkout6.png
   
   
3. Создаём в своей "домашней папке" под вашим именем - папку "vitahelloworld".
   Должен получиться следующий путь: C:\PSDK3v3\MinGW\msys\1.0\home\Ваше_Имя\vitahelloworld
   
   
4. Нажимаем правой кнопкой по вновь созданной папке и выбираем "Checkout.png SVN Checkout...". Скачиваем исходники.
   
   SVN Checkout7.png
   
   Примечание: этот момент мы рассматривали в Часть 1 данной инструкции. Вспомнили?
   
   
5. Запускаем консольное окно батником msys.bat из папки C:\PSDK3v3\MinGW\msys\1.0 или ярлыком с рабочего стола.
   
   
6. В консоли зелёными буквами вы видите свою домашнюю папку (в которой находитесь в данный момент) - это папка C:\PSDK3v3\MinGW\msys\1.0\home\Ваше_Имя. Имейте это в виду.
   
   
7. Чтобы пройти в папку с исходниками, введите команду: cd vitahelloworld/trunk
   
   
8. Теперь, когда мы находимся в папке с исходниками, содержащей файл Makefile, введите команду make и следите за ходом компиляции:
   
   VitaHelloWorld.png
   
   
9. Поздравляем! Вы скомпилировали свою первую программу! Забирайте из папки с исходниками готовый vitahelloworld.vpk, устанавливайте на PS Vita и проверяйте.
   
   
10. Чтобы удалить результаты компиляции, введите команду make clean.

Часть 4. Компиляция с помощью CMake Top-button.gif

Данная часть 4 инструкции применяется для исходников, в которых имеется файл CMakeLists.txt.

1. Идём за исходниками в репозиторий: https://github.com/henkaku/offline-installer
   
   
2. Точно так же, как вы уже ознакомлены ранее, создаём пустую папку в домашнем каталоге и затягиваем туда исходники программы "HENkaku Offline Installer".
   
   
3. Заходим в папку C:\PSDK3v3\MinGW\msys\1.0\home\Ваше_Имя\offline-installer\trunk и видим там файл CMakeLists.txt. Это значит, что исходный код подготовлен таким образом, чтобы компилироваться с помощью скрипта из этого файла, а в качестве компилятора используется кросс-платформенный компилятор CMake.
   
   
4. Скачиваем и устанавливаем последнюю версию под свою платформу и битность: https://cmake.org/download/
   
   
5. На пока что, отложим CMake в сторону, потому что на данном этапе мы пока скомпилировать сразу ничего не сможем, т.к. получим ошибку по поводу sqlite. Как можно заметить, проверив вложенные папки, там прилагается папка sqlite-3.6.23.1, в которой лежат файлы Makefile.am и Makefile.in, но нет нужного нам файла просто Makefile. Но, как полагается, там лежит файл INSTALL, о котором упоминается в README. Поэтому, двигаемся дальше по следующему сценарию...
   
   
6. Запускаем консольное окно батником msys.bat из папки C:\PSDK3v3\MinGW\msys\1.0 или ярлыком с рабочего стола.
   
   
7. В консоли зелёными буквами вы видите свою домашнюю папку (в которой находитесь в данный момент) - это папка C:\PSDK3v3\MinGW\msys\1.0\home\Ваше_Имя
   
   
8. Чтобы пройти в папку с sqlite-3.6.23.1, введите команду: cd offline-installer/trunk/sqlite-3.6.23.1
   
   
9. Теперь, когда мы находимся в нужной папке, необходимо сконфигурировать исходники, для этого введите команду ./configure
   
   configure.png
   
   Таким образом, программа проверит наличие необходимых компиляторов и библиотек в системе и в случае удачи, сгенерирует файл Makefile, необходимый нам для компиляции.
   
   
10. Далее, когда Makefile появился в папке, выполняем команду make.
    
    make_sqlite3.png
    
    
11. У нас скомпилировались необходимые важные библиотеки *.a и *.dll в папке .libs, а так же, консольный экзешник sqlite3.exe, которые можно установить в системе, следом выполнив команду: make install.
    
    make_install_sqlite3.png
    
    
12. Настало время CMake. Запускаем ярлык на рабочем столе: CMake (cmake-gui)
    
    
13. В первой строке "Where is the source code" указываем путь к папке, где лежит скрипт CMakeLists.txt
    Это папка: C:/PSDK3v3/MinGW/msys/1.0/home/Ваше_Имя/offline-installer/trunk
    
    
14. Во второй строке "Where to build the binares" указываем путь к папке, где будет происходить компиляция.
    Это папка: C:/PSDK3v3/MinGW/msys/1.0/home/Ваше_Имя/offline-installer/trunk/src
    
    
15. Нажмите кнопку "Configure" и в появившемся окне выберите из раскрывающегося списка "MSYS Makefiles"
    
    CMake.png
    
    
16. При нажатии на "Finish" пойдёт процесс проверки конфигурации и если всё ОК, появится сообщение в логе "Configuring done".
    
    
17. Нажмите на кнопку "Generate", чтобы сгенерировался Makefile и если всё ОК, то появится сообщение в логе "Generating done".
    
    CMake2.png
    
    
18. Теперь в папке src можно заметить, что появился файл Makefile, а значит можно компилировать программу.
    
    
19. Снова запускаем консоль через msys.bat и идём в папку src с Makefile: cd offline-installer/trunk/src
    
    
20. Выполняем команду на компиляцию: make
    
    make_offlineInstaller.png
    
    
21. Забираем готовую скомпилированную программу offlineInstaller.vpk
    
    offlineInstaller.vpk.png
    
    В папке вы видите 2 файла font.c и main.c с восклицательным знакомExclamation.png- это TortoiseSVN так помечает изменённые файлы.
    • В font.c я заменил английский шрифт на шрифт с кириллицей.
    • В main.c я сделал перевод текста на русский.
    Другие файлы со знаком вопросаQuestion.png- это неизвестные новые файлы, создавшиеся во время компиляции.
    
    
22. На этом всё! Исходники русификации offlineInstaller прилагаются во вложении. Надеюсь вам посчастливится выполнить инструкцию удачно...

Top-button.gif

---

Ну и в дополнение, для расширения фугкционала, рекомендую иметь на компьютере следующие компиляторы:

• Cygwin:
  • setup-x86.exe (32-bit installation) - для 32-битных систем.
  • setup-x86_64.exe (64-bit installation) - для 64-битных систем.
• Strawberry Perl
  
• Python
  
• Java
  
• MinGW - Minimalist GNU for Windows
  
  И конечно, проверить на добавление записей к папке bin в "Переменные среды".