Как запустить OpenKore

Содержание

1 (НЕ) поддерживаемые дистрибутивы Linux и ОС
2 Быстрый запуск
3 Требования
4 Запуск OpenKore
5 Аргументы командной строки
- 5.1 --help
6 Общие проблемы
7 Скомпилированные бинарники

(НЕ) поддерживаемые дистрибутивы Linux и ОС

OpenKore не работает на некоторых дистрибутивах live CD, потому что в них нет минимального необходимого ПО. На следующих дистрибутивах OpenKore не работает:

Knoppix
elxLinux

OpenKore гарантированно работает на:

Windows 2000, XP, 2003, 7, 8, 8.1, 10 (WSL Ubuntu 20.04)
Ubuntu
Fedora
FreeBSD
MacOS X
Solaris 8

Бот также работает на 64-битных linux и windows системах.

Быстрый запуск

Предполагается, что у Вас уже установлена ОС.

Windows

Запустите start.exe (консольный интерфейс) или wxstart.exe (WX-интерфейс) или openkore.pl (требуется интерпретатор perl, например strawberry-perl-5.12 32bit).

Windows WSL (Ubuntu)

Версия WSL: 2, версия Ubuntu: 20.04

Установите WSL согласно официальной документации
Установите необходимые модули и библиотеки (см. требования для Ubuntu)
Запустите openkore.pl (при первом запуске должна скомпилироваться библиотека XSTools.so)

OS X

Версия 10.8.2

Получите Apple ID если у Вас его ещё нет (нужно загрузить только инструменты командной строки для Xcode с сайта Apple).
Станьте разработчиком Apple (нужно загрузить только инструменты командной строки для Xcode с сайта Apple).
Установите инструменты командной строки для Xcode.
Установите Homebrew. Запустите brew doctor и др. если Homebrew попросит.
Установите readline выполнив команду: brew install readline.
Запустите openkore.pl (при первом запуске должна скомпилироваться библиотека XSTools.so)

Требования

До запуска OpenKore убедитесь, что у вас установлены следующие компоненты:

Компилятор C/C++

У вас должен быть установлен компилятор C или C++ (требуется только для компиляции XSTools). GCC по умолчанию установлен во многих дистрибутивах Linux, но, некоторые люди устанавливают Linux без GCC.

Чтобы проверить, установлен ли у вас компилятор C++, откройте терминал и введите:

g++ -v

Если вы не получили сообщение об ошибке, значит у вас уже есть компилятор C++, и вы можете перейти к следующему шагу. Для Ubuntu также следует проверить наличие пакета dpkg -l | grep build-essential.
Если компилятор C++ отсутствует, то ознакомьтесь с таблицей ниже:

ОС/Дистрибутив	Примечание
Windows	Компиляции XSTools не требуется. Дистрибутив OpenKore содержит в себе XSTools.dll, скомпилированую под версию perl 5.12
Ubuntu / Debian	Откройте терминал и введите: `su -c 'apt-get install build-essential g++'`
RHEL / Fedora / CentOS	Откройте терминал и введите: `su -c 'yum install gcc-c++'`
(Open)Suse	Откройте терминал и введите: `su -c 'yast -i gcc-c++'`
Arch	Для i686, откройте терминал и введите: `su -c 'pacman -S base-devel'` Для x86_64: `su -c 'pacman -S multilib-devel'`
MacOS X	Установите Command Line Tools для Xcode Дополнительная информация: http://www.tech-recipes.com/mac_system_administration_tips726.html
Другие ОС	Найдите пакеты gcc, and gcc-c++ or g++ самостоятельно.

Perl

У вас должен быть установлен Perl версии 5.12 или выше (для Windows требуется только верси 5.12 x32). Более ранние версии могут не поддерживаться! Чтобы проверить, установлен ли у вас Perl, введите:

perl -v | find "version" # для windows
perl -v | grep perl      # для linux

Если вы видите версию Perl, значит, он установлен. Если версия соответствует рекомендуемой, то переходите к следующему шагу. Если вы получили сообщение об ошибке, значит, он не установлен. Тогда ознакомьтесь с таблицей ниже:

ОС/Дистрибутив	Примечание
Windows	Установите Strawberry Perl или ActivePerl
Ubuntu / Debian	Откройте терминал и введите: `su -c 'apt-get install perl-base'`
RHEL / Fedora / CentOS	Откройте терминал и введите: `su -c 'yum install perl'`
Arch	Откройте терминал и введите: `su -c 'pacman -S perl'`
FreeBSD	Perl 5.8 скорее всего установлен по умолчанию. Иначе откройте терминал и введите: `su -c 'pkg_add -r perl5.8'`
MacOS X	Прочитайте http://developer.apple.com/internet/opensource/perl.html
Другие ОС	Скачайте с http://www.perl.org/

Модуль Perl: Time::HiRes

У вас должен быть установлен модуль Time::HiRes. Вы можете проверить это командой:

perl -e "use Time::HiRes;"

Если выводится пустое сообщение, то модуль установлен, и вы можете перейти к следующему шагу. Если вы получили сообщение об ошибке, значит, он не установлен. Тогда ознакомьтесь с таблицей ниже:

ОС/Дистрибутив	Примечание
Windows со strawberry или ActivePerl	Команда: `ppm install Time::HiRes` или `cpan Time::HiRes`
Ubuntu / Debian	Откройте терминал и введите: `su -c 'apt-get install libtime-hires-perl'`
RHEL / Fedora / CentOS	Откройте терминал и введите: `su -c 'yum install perl-Time-HiRes'`
Arch	Откройте терминал и введите: `su -c 'pacman -S perl-time-hires'`
FreeBSD	Откройте терминал и введите: `su -c 'pkg_add -r p5-Time-HiRes'`
Другие ОС	Скачайте исходник модуля "Time::HiRes" с CPAN, скомпилируйте и установите его. Если у вас есть CPAN, то используйте команду: `cpan Time::HiRes`

Модуль Perl: Compress::Zlib

У вас должен быть установлен модуль Compress::Zlib. Вы можете проверить это командой:

perl -e "use Compress::Zlib;"

Если выводится пустое сообщение, то модуль установлен, и вы можете перейти к следующему шагу. Если вы получили сообщение об ошибке, значит, он не установлен. Тогда ознакомьтесь с таблицей ниже:

ОС/Дистрибутив	Примечание
Windows со strawberry или ActivePerl	Команда: `ppm install Compress::Zlib` или `cpan Compress::Zlib`
Ubuntu/Debian	Откройте терминал и введите: `su -c 'apt-get install libcompress-zlib-perl'`
RHEL / Fedora / CentOS	Откройте терминал и введите: `su -c 'yum install perl-Compress-Zlib'`
Arch	Установите модуль "perl-io-compress" из ArchLinux User Repository.
FreeBSD	Откройте терминал и введите: `su -c 'pkg_add -r p5-Compress-Zlib'`
Другие ОС	Скачайте исходник модуля "Compress::Zlib" с CPAN, скомпилируйте и установите его. Если у вас есть CPAN, то используйте команду: `cpan Compress::Zlib`

Библиотека GNU readline

Требуется только для интерфейса Console::Unix.
Не требуется для Windows.
Используйте параметр --interface=Console::Simple, --interface=Console::Curses или --interface=Wx если readline не доступен.

У вас должа быть установлена библиотека GNU readline и связанные с ней зависимости. Нужна версия 5.0 или выше. Вы можете проверить это следующим образом:

1) cоздайте файл readlinetest.c в вашей домашней директории со следующим содержимым:

#include <stdio.h>
#include <readline/readline.h>
  #if !defined(RL_READLINE_VERSION)
    #error "You do not have the GNU readline development headers installed!"
  #elif RL_READLINE_VERSION < 0x0500
    #error "Your version of GNU readline is too old. Please install version 5.0 or higher."
  #endif

Примечание: Файл должен заканчиваться пустой строкой.

2) откройте терминал и введите команду:

gcc -c ~/readlinetest.c

Если выводится пустое сообщение, то библиотека установлена, и вы можете перейти к следующему шагу. Если вы получили сообщение об ошибке, значит, она не установлена. Тогда ознакомьтесь с таблицей ниже:

ОС/Дистрибутив	Примечание
Ubuntu 14.04	Откройте терминал и введите: `su -c 'apt-get install libreadline6-dev'`
Ubuntu 12.04 / Debian	Откройте терминал и введите: `su -c 'apt-get install libreadline5-dev'`
RHEL / Fedora / CentOS	Откройте терминал и введите: `su -c 'yum install readline-devel'`
Arch	Откройте терминал и введите: `su -c 'pacman -S readline'`
FreeBSD	...
MacOS X	Установите readline с помощью brew: `brew install readline` Не устанавливайте readline с помощью Fink! Это не работает.
Другие ОС	Скомпилируйет и установите readline самостоятельно: Скачайте исходный код последней версии readline (на момент написания этой статьи была версия: readline-5.1.tar.gz). Откройте терминал и введите: `tar xzvf readline-X.X.tar.gz && cd readline-X.X`, где X.X - это версия библиотеки. Введите `./configure && make && su -c 'make install'`

Python

У вас должен быть установлен Python (требуется для компиляции XSTools). Вы можете проверить это командой:

echo 'print "Python is installed"' | python

Если увидите сообщение "Python is installed", тогда Python уже становлен, и вы можете перейти к следующему шагу. Для установки Python ознакомьтесь с таблицей ниже:

ОС/Дистрибутив	Примечание
Windows	Python необходим только в том случае, если вам нужно перекомпилировать XSTools. Скачать Python
Ubuntu / Debian	Откройте терминал и введите: `su -c 'apt-get install python'`
RHEL / Fedora / CentOS	Откройте терминал и введите: `su -c 'yum install python'`
Arch	Откройте терминал и введите: `su -c 'pacman -S python2'`
FreeBSD	Откройте терминал и введите: `su -c 'pkg_add -r python'`
MacOS X	Скачайте Python здесь

Библиотеки разработки Curl

У вас должны быть установлены библиотеки разработки Curl (требуется для компиляции XSTools). Вы можете проверить это командой:

curl-config --version

Если увидите ошибку "Command 'curl-config' not found", значит библиотеки не установлены. Тогда ознакомьтесь с таблицей ниже:

ОС/Дистрибутив	Примечание
Ubuntu / Debian	1) найдите доступную версию libcurl: `apt-cache search libcurl` 2)Установите последнюю версию: `su -c 'apt-get install libcurlX-dev'`, где 'X' - это номер версии
RHEL / Fedora / CentOS	Откройте терминал и введите: `su -c 'yum install curl-devel'`
Arch	Откройте терминал и введите: `su -c 'pacman -S curl'`
FreeBSD	Откройте терминал и введите: `su -c 'pkg_add -r curl'`
Другие ОС	Установите libcurl из исходников (домашняя страница Curl)

Модуль Perl: Win32::Console

(только для консольного интерфейса Windows)

Команда ppm install Win32::Console или cpan Win32::Console

Запуск OpenKore

Загрузка дистрибутива

Скачайте дистрибутив OpenKore с github.com/openkore.

Распаковка архива

Распакуйте архив, как указано на странице загрузки.

Запуск

Откройте папку с OpenKore и запустите соответствующий файл:

для Windows: запустите start.exe для запуска консольного режима или wxstart.exe - для запуска WX-интерфейса
для Linux: откройте терминал и введите: perl ./openkore.pl. Если всё сделади павильно, то OpenKore автоматически попытается скомпилировать XSTools.so (внутреннюю библиотеку). Если компиляция не удалась, проверьте общие проблемы. Если вы не нашли решение, то сообщите об ошибке разработчикам.

Аргументы командной строки

--help

покажет актуальную информацию об аргументах командной строки

Общие проблемы

Missing headers

Частая причина сбоя компиляции - отсутствие заголовков. Просмотрите вывод консоли при компиляции. Есть ли среди сообщений подобное?

foo.h: No such file or directory

Если да, то это означает, что вы не установили необходимые модули\библиотеки. Проверьте требования ещё раз.

hash_fun.h

In file included from src/auto/XSTools/utils/perl/Benchmark.xs:1:
src/auto/XSTools/utils/perl/../dense_hash_map.h:93:66: error: ext/hash_fun.h: No such file or directory

Откройте src/auto/XSTools/utils/sparseconfig.h, найдите:

#define HASH_FUN_H <ext/hash_fun.h>

и змените на:

#define HASH_FUN_H <backward/hash_fun.h>

scons: *** SCons version 2.0.1 does not run under Python version 3.2.2.

Откройте вызываемый Makefile, изамените везде

python

на

python2

Всё остальное оставьте как есть. Убедитесь, что у вас установлен python-2.x, если вы столкнулись подобной ошибкой.

scons: *** [src/auto/XSTools/utils/perl/Benchmark.os] Error 1

Откройте файл src/auto/XSTools/utils/densehashtable.h и найдите:

#include "sparseconfig.h"

после этой строчки вставьте слебующую строчку:

#include <stddef.h>

После этого XSTools должна скомпилироваться.

Скомпилированные бинарники

Если вы используете Windows, то можете использовать готовые бинарники, которые содержат интепритатор perl и все необходимые модули.