Как запустить OpenKore: различия между версиями

Материал из Руководство по OpenKore
Перейти к навигации Перейти к поиску
Нет описания правки
Нет описания правки
 
(не показано 8 промежуточных версий этого же участника)
Строка 7: Строка 7:
OpenKore гарантированно работает на:
OpenKore гарантированно работает на:


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


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


== Быстрый запуск ==
== Быстрый запуск ==
Строка 20: Строка 20:


=== Windows ===
=== Windows ===
* Запустите <code>start.exe</code>, <code>wxstart.exe</code> (запуск WX-интерфейса) или <code>openkore.pl</code> (требуется [[How_to_run_OpenKore#Perl|интерпретатор perl]]).
* Запустите <code>start.exe</code> ([[Console_интерфейс|консольный интерфейс]]) или <code>wxstart.exe</code> ([[Wx_интерфейс|WX-интерфейс]]) или <code>openkore.pl</code> (требуется [[Как_запустить_OpenKore#Perl|интерпретатор perl]], например [http://strawberryperl.com/download/5.12.3.0/strawberry-perl-5.12.3.0.msi strawberry-perl-5.12 32bit]).
 
=== Windows WSL (Ubuntu) ===
''Версия WSL: 2, версия Ubuntu: 20.04''
* Установите WSL согласно [https://docs.microsoft.com/ru-ru/windows/wsl/install-win10 официальной документации]
* Установите необходимые модули и библиотеки (см. [[Как_запустить_OpenKore#Требования|требования]] для Ubuntu)
* Запустите <code>openkore.pl</code> (при первом запуске должна скомпилироваться библиотека '''XSTools.so''')


=== OS X ===
=== OS X ===
Строка 29: Строка 35:
* Установите [https://github.com/Homebrew/brew/ Homebrew]. Запустите <code>brew doctor</code> и др. если Homebrew попросит.
* Установите [https://github.com/Homebrew/brew/ Homebrew]. Запустите <code>brew doctor</code> и др. если Homebrew попросит.
* Установите readline выполнив команду: <code>brew install readline</code>.
* Установите readline выполнив команду: <code>brew install readline</code>.
* Запустите <code>openkore.pl</code>.
* Запустите <code>openkore.pl</code> (при первом запуске должна скомпилироваться библиотека '''XSTools.so''')


== Requirements ==
You must first make sure that you have several things installed before you can run OpenKore.


=== C/C++ compiler ===
== Требования ==
До запуска OpenKore убедитесь, что у вас установлены следующие компоненты:
 
=== Компилятор C/C++ ===
----
----
You must have a C and C++ compiler installed (this is only required to compile XSTools). GCC is installed by default on many Linux distributions, but apparently some people install Linux without GCC.
У вас должен быть установлен компилятор C или C++ (требуется только для компиляции XSTools). GCC по умолчанию установлен во многих дистрибутивах Linux, но, некоторые люди устанавливают Linux без GCC.


To check whether you have a C++ compiler installed, open a terminal and type:
Чтобы проверить, установлен ли у вас компилятор C++, откройте терминал и введите:


  g++ -v
  g++ -v


If you don't get an error, then you have a C++ compiler, and you can skip to the next paragraph. If not, read the table below.
Если вы не получили сообщение об ошибке, значит у вас уже есть компилятор C++, и вы можете перейти к следующему шагу. Для Ubuntu также следует проверить наличие пакета <code>dpkg -l | grep build-essential</code>.
<br>Если компилятор C++ отсутствует, то ознакомьтесь с таблицей ниже:


{|border="1" cellpadding="2" cellspacing="1"  
{|border="1" cellpadding="2" cellspacing="1"  
|- style=background-color:#F9F9F9;
|- style=background-color:#F9F9F9;
!OS/distribution
!ОС/Дистрибутив
!Instructions
!Примечание
|-
|-
|align=center|Fedora/RHEL/CentOS
|align=center|Windows
|Open a terminal and type:
|Компиляции XSTools не требуется. Дистрибутив OpenKore содержит в себе XSTools.dll, скомпилированую под версию perl 5.12
su -c 'yum install gcc-c++'
|-
|-
|align=center|Ubuntu
|align=center|Ubuntu / Debian
|Open a terminal and type:  
|Откройте терминал и введите: <code>su -c 'apt-get install build-essential g++'</code>
sudo apt-get install build-essential g++
|-
|-
|align=center|Debian
|align=center|RHEL / Fedora / CentOS
|Open a terminal and type:
|Откройте терминал и введите: <code>su -c 'yum install gcc-c++'</code>
su -c 'apt-get install build-essential g++'
|-
|-
|align=center|(Open)Suse
|align=center|(Open)Suse
|Open a terminal and type:  
|Откройте терминал и введите: <code>su -c 'yast -i gcc-c++'</code>
su -c 'yast -i gcc-c++'
|-
|-
|align=center|Arch
|align=center|Arch
|On i686, open a terminal and type:  
|Для i686, откройте терминал и введите: <code>su -c 'pacman -S base-devel'</code>
su -c 'pacman -S base-devel'
Для x86_64: <code>su -c 'pacman -S multilib-devel'</code>
or, if you're on x86_64:
su -c 'pacman -S multilib-devel'
|-
|align=center|Other Linux distributions
|Look in your distribution's CD for packages called gcc, and gcc-c++ or g++.
|-
|-
|align=center|MacOS X
|align=center|MacOS X
|Install [https://developer.apple.com/downloads/ Command Line Tools for Xcode]
|Установите [https://developer.apple.com/downloads/ Command Line Tools для Xcode]


Additional information: http://www.tech-recipes.com/mac_system_administration_tips726.html
Дополнительная информация: http://www.tech-recipes.com/mac_system_administration_tips726.html
|-
|align=center|Другие ОС
|Найдите пакеты gcc, and gcc-c++ or g++ самостоятельно.
|}
|}


=== Perl ===
=== Perl ===
----
----


You must have Perl '''5.10.1''' or newer installed (actually, 5.8.x may work, but kRO serverTypes and some other features won't work). Earlier versions might not be supported! To check whether you have Perl installed (and whether it is the correct version), type:
У вас должен быть установлен Perl версии '''5.12''' или выше (для Windows требуется только верси 5.12 x32). Более ранние версии могут не поддерживаться! Чтобы проверить, установлен ли у вас Perl, введите:
 
perl -v | find "version" # для windows
  perl -v | grep perl
  perl -v | grep perl     # для linux
 
If you see the Perl version number, then it is installed. If you get an error, then it is not installed, and you should read the following table.


Thread support is needed for default interface to work (otherwise, use Console::Simple interface):
Если вы видите версию Perl, значит, он установлен. Если версия соответствует рекомендуемой, то переходите к следующему шагу. Если вы получили сообщение об ошибке, значит, он не установлен. Тогда ознакомьтесь с таблицей ниже:
perl -V | grep threads


{|border="1" cellpadding="2" cellspacing="1"  
{|border="1" cellpadding="2" cellspacing="1"  
|- style=background-color:#F9F9F9;
|- style=background-color:#F9F9F9;
!OS/distribution
!ОС/Дистрибутив
!Instructions
!Примечание
|-
|-
|align=center|Fedora/RHEL/CentOS
|align=center|Windows
|Open a terminal and type:
|Установите [http://strawberryperl.com/releases.html Strawberry Perl] или [http://www.activestate.com/activeperl/ ActivePerl]
su -c 'yum install perl'
|-
|-
|align=center|Ubuntu
|align=center|Ubuntu / Debian
|Open a terminal and type:
|Откройте терминал и введите: <code>su -c 'apt-get install perl-base'</code>
sudo apt-get install perl
|-
|-
|align=center|Debian
|align=center|RHEL / Fedora / CentOS
|Open a terminal and type:
|Откройте терминал и введите: <code>su -c 'yum install perl'</code>
su -c 'apt-get install perl-base'
|-
|-
|align=center|Arch
|align=center|Arch
|Open a terminal and type:  
|Откройте терминал и введите: <code>su -c 'pacman -S perl'</code>
su -c 'pacman -S perl'
|-
|align=center|Other Linux distributions
|Download it from http://www.perl.org/
|-
|-
|align=center|FreeBSD
|align=center|FreeBSD
| Perl 5.8 probably comes in default installation.
| Perl 5.8 скорее всего установлен по умолчанию.
Otherwise, open a terminal and type:
Иначе откройте терминал и введите: <code>su -c 'pkg_add -r perl5.8'</code>
su -c 'pkg_add -r perl5.8'
|-
|-
|align=center|MacOS X
|align=center|MacOS X
|Read http://developer.apple.com/internet/opensource/perl.html
|Прочитайте http://developer.apple.com/internet/opensource/perl.html
|-
|-
|align=center|Windows
|align=center|Другие ОС
|Install [http://strawberryperl.com/ Strawberry Perl] or [http://www.activestate.com/activeperl/ ActivePerl]
|Скачайте с http://www.perl.org/
|}
|}


=== Perl module: Time::HiRes ===
 
=== Модуль Perl: Time::HiRes ===
----
----
You need the Time::HiRes Perl module. You can check whether you already have it by typing
У вас должен быть установлен модуль '''Time::HiRes'''. Вы можете проверить это командой:
perl -e "use Time::HiRes;"


perl -e 'use Time::HiRes;'
Если выводится пустое сообщение, то модуль установлен, и вы можете перейти к следующему шагу. Если вы получили сообщение об ошибке, значит, он не установлен. Тогда ознакомьтесь с таблицей ниже:
 
If nothing happens, then it is installed, and you can skip to the next paragraph. If you get an error, then it is not installed, and you should read the following table.


{|border="1" cellpadding="2" cellspacing="1"  
{|border="1" cellpadding="2" cellspacing="1"  
|- style=background-color:#F9F9F9;
|- style=background-color:#F9F9F9;
!OS/distribution
!ОС/Дистрибутив
!Instructions
!Примечание
|-
|-
|align=center|Fedora/RHEL/CentOS
|align=center|Windows со strawberry или ActivePerl
|Open a terminal and type:
|Команда: <code>ppm install Time::HiRes</code> или <code>cpan Time::HiRes</code>
su -c 'yum install perl-Time-HiRes'
|-
|-
|align=center|Debian
|align=center|Ubuntu / Debian
|Open a terminal and type:
|Откройте терминал и введите: <code>su -c 'apt-get install libtime-hires-perl'</code>
su -c 'apt-get install libtime-hires-perl'
|-
|-
|align=center|FreeBSD
|align=center|RHEL / Fedora / CentOS
|Open a terminal and type:
|Откройте терминал и введите: <code>su -c 'yum install perl-Time-HiRes'</code>
su -c 'pkg_add -r p5-Time-HiRes'
|-
|-
|align=center|Arch
|align=center|Arch
|Open a terminal and type:  
|Откройте терминал и введите: <code>su -c 'pacman -S perl-time-hires'</code>
su -c 'pacman -S perl-time-hires'
|-
|-
|align=center|Other operating systems or Linux distributions
|align=center|FreeBSD
|Download the Time::HiRes source code from CPAN and compile and install it.
|Откройте терминал и введите: <code>su -c 'pkg_add -r p5-Time-HiRes'</code>
If you have CPAN:
cpan Time::HiRes
|-
|-
|align=center|Windows with ActivePerl
|align=center|Другие ОС
|Install via <code>ppm</code>.
|Скачайте исходник модуля "Time::HiRes" с CPAN, скомпилируйте и установите его.
Если у вас есть CPAN, то используйте команду: <code>cpan Time::HiRes</code>
|}
|}




=== Perl module: Compress::Zlib ===
=== Модуль Perl: Compress::Zlib ===
----
----
You need the Compress::Zlib Perl module. You can check whether you already have it by typing
У вас должен быть установлен модуль '''Compress::Zlib'''. Вы можете проверить это командой:
perl -e "use Compress::Zlib;"


perl -e 'use Compress::Zlib;'
Если выводится пустое сообщение, то модуль установлен, и вы можете перейти к следующему шагу. Если вы получили сообщение об ошибке, значит, он не установлен. Тогда ознакомьтесь с таблицей ниже:
 
If nothing happens, then it is installed, and you can skip to the next paragraph. If you get an error, then it is not installed, and you should read the following table.


{|border="1" cellpadding="2" cellspacing="1"  
{|border="1" cellpadding="2" cellspacing="1"  
|- style=background-color:#F9F9F9;
|- style=background-color:#F9F9F9;
!OS/distribution
!ОС/Дистрибутив
!Instructions
!Примечание
|-
|-
|align=center|Ubuntu
|align=center|Windows со strawberry или ActivePerl
|Open a terminal and type:
|Команда: <code>ppm install Compress::Zlib</code> или <code>cpan Compress::Zlib</code>
sudo apt-get install libcompress-zlib-perl
|-
|-
|align=center|FreeBSD
|align=center|Ubuntu/Debian
|Open a terminal and type:
|Откройте терминал и введите: <code>su -c 'apt-get install libcompress-zlib-perl'</code>
su -c 'pkg_add -r p5-Compress-Zlib
|-
|align=center|RHEL / Fedora / CentOS
|Откройте терминал и введите: <code>su -c 'yum install perl-Compress-Zlib'</code>
|-
|-
|align=center|Arch
|align=center|Arch
|Install perl-io-compress from the [https://aur.archlinux.org/packages.php?ID=34517 Arch User Repository].
|Установите модуль "perl-io-compress" из [https://aur.archlinux.org/packages/?O=0&SeB=nd&K=perl-io-compress&outdated=&SB=n&SO=a&PP=50&do_Search=Go ArchLinux User Repository].
|-
|-
|align=center|Other operating systems or Linux distributions
|align=center|FreeBSD
|Download the Compress::Zlib source code from CPAN and compile and install it.
|Откройте терминал и введите: <code>su -c 'pkg_add -r p5-Compress-Zlib'</code>
If you have CPAN:
cpan Compress::Zlib
|-
|-
|align=center|Windows with ActivePerl
|align=center|Другие ОС
|Install via <code>ppm</code>.
|Скачайте исходник модуля "Compress::Zlib" с CPAN, скомпилируйте и установите его.
Если у вас есть CPAN, то используйте команду: <code>cpan Compress::Zlib</code>
|}
|}




=== GNU readline ===
=== Библиотека GNU readline ===
----
----
* Required only for Console::Unix [[:Category:Interfaces|interface]].
* Требуется только для интерфейса [[:Category:Interfaces|Console::Unix]].
* Not required on Windows.
* Не требуется для Windows.
* Use <code>--interface=Console::Simple</code>, Console::Curses or Wx if readline isn't available.
* Используйте параметр <code>--interface=Console::Simple</code>, <code>--interface=Console::Curses</code> или <code>--interface=Wx</code> если '''readline''' не доступен.


GNU readline and its associated development package must be installed. You need at least version 5.0. To check whether you have a recent enough version of GNU readline, follow the following instructions:
У вас должа быть установлена библиотека '''GNU readline''' и связанные с ней зависимости. Нужна версия 5.0 или выше. Вы можете проверить это следующим образом:


# Copy and past the following text into a text editor:
: 1) cоздайте файл '''readlinetest.c''' в вашей домашней директории со следующим содержимым:


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


'''Note.''' The file must end with an empty line
: '''Примечание:''' Файл должен заканчиваться пустой строкой.


# Save the file as readlinetest.c in your home folder.
: 2) откройте терминал и введите команду:
# Open a terminal and type:


  gcc -c ~/readlinetest.c
  gcc -c ~/readlinetest.c


If you do not see any output, then that means you have GNU readline correctly installed, and you can skip to the next paragraph. If you do see an error message, then read the following table.
: Если выводится пустое сообщение, то библиотека установлена, и вы можете перейти к следующему шагу. Если вы получили сообщение об ошибке, значит, она не установлена. Тогда ознакомьтесь с таблицей ниже:


{|border="1" cellpadding="2" cellspacing="1"  
{|border="1" cellpadding="2" cellspacing="1"  
|- style=background-color:#F9F9F9;
|- style=background-color:#F9F9F9;
!OS/distribution
!ОС/Дистрибутив
!Instructions
!Примечание
|-
|-
|align=center|Fedora/RHEL/CentOS
|align=center|Ubuntu 14.04
|Open a terminal and type:
|Откройте терминал и введите: <code>su -c 'apt-get install libreadline6-dev'</code>
su -c 'yum install readline-devel'
|-
|-
|align=center|Debian / Ubuntu 12.04
|align=center|Ubuntu 12.04 / Debian
|Open a terminal and type:
|Откройте терминал и введите: <code>su -c 'apt-get install libreadline5-dev'</code>
su -c 'apt-get install libreadline5-dev'
|-
|-
|align=center|Ubuntu 14.04
|align=center|RHEL / Fedora / CentOS
|Open a terminal and type:
|Откройте терминал и введите: <code>su -c 'yum install readline-devel'</code>
sudo apt-get install libreadline6-dev
|-
|-
|align=center|Arch
|align=center|Arch
|Open a terminal and type:  
|Откройте терминал и введите: <code>su -c 'pacman -S readline'</code>
su -c 'pacman -S readline'
|-
|align=center|OS X
|Install [http://braumeister.org/formula/readline readline] with [https://github.com/Homebrew/brew/ brew]:
brew install readline
|-
|-
|align=center|FreeBSD
|align=center|FreeBSD
|...
|...
|-
|-
|align=center|Other operating systems or Linux distributions
|align=center|MacOS X
|You must compile readline and install readline from source.
|Установите [http://braumeister.org/formula/readline readline] с помощью [https://github.com/Homebrew/brew/ brew]: <code>brew install readline</code>
Не устанавливайте '''readline''' с помощью Fink! Это не работает.
|-
|align=center|Другие ОС
|Скомпилируйет и установите '''readline''' самостоятельно:
# Скачайте исходный код последней версии [ftp://ftp.cwru.edu/pub/bash/ readline] (на момент написания этой статьи была версия: readline-5.1.tar.gz).
# Откройте терминал и введите: <code>tar xzvf readline-X.X.tar.gz && cd readline-X.X</code>, где X.X - это версия библиотеки.
# Введите <code>./configure && make && su -c 'make install'</code>
|}
|}


# Download the readline source code from the GNU FTP. You should download the latest version (at the time this page is written, the latest version is readline-5.1.tar.gz). Save the file to your home folder.
# Open a terminal, and type:
tar xzvf readline-X.X.tar.gz && cd readline-X.X
Where X.X is the version of the file you downloaded/
# Type:
./configure && make && su -c 'make install'
'''MacOS X note.''' Do not install Readline from Fink! That won't work.


=== Python ===
=== Python ===
----
----
Python must be installed (this is only required to compile XSTools). To check whether you have it, type:
У вас должен быть установлен '''Python''' (требуется для компиляции XSTools). Вы можете проверить это командой:


  echo 'print "Python is installed"' | python
  echo 'print "Python is installed"' | python


If you get the message "Python is installed", then Python is installed, and you can skip to the next paragraph. If Python is not installed, then read the following table.
Если увидите сообщение "Python is installed", тогда Python уже становлен, и вы можете перейти к следующему шагу. Для установки Python ознакомьтесь с таблицей ниже:


{|border="1" cellpadding="2" cellspacing="1"  
{|border="1" cellpadding="2" cellspacing="1"  
|- style=background-color:#F9F9F9;
|- style=background-color:#F9F9F9;
!OS/distribution
!ОС/Дистрибутив
!Instructions
!Примечание
|-
|-
|align=center|Fedora/RHEL/CentOS
|align=center|Windows
|Open a terminal and type:
|Python необходим только в том случае, если вам нужно перекомпилировать XSTools. [https://www.python.org/downloads/windows/ Скачать Python]
su -c 'yum install python'
|-
|-
|align=center|Ubuntu
|align=center|Ubuntu / Debian
|Open a terminal and type:
|Откройте терминал и введите: <code>su -c 'apt-get install python'</code>
sudo apt-get install python
|-
|-
|align=center|Debian
|align=center|RHEL / Fedora / CentOS
|Open a terminal and type:
|Откройте терминал и введите: <code>su -c 'yum install python'</code>
su -c 'apt-get install python'
|-
|-
|align=center|FreeBSD
|align=center|Arch
|Open a terminal and type
|Откройте терминал и введите: <code>su -c 'pacman -S python2'</code>
su -c 'pkg_add -r python'
|-
|-
|align=center|Arch
|align=center|FreeBSD
|Open a terminal and type:  
|Откройте терминал и введите: <code>su -c 'pkg_add -r python'</code>
su -c 'pacman -S python2'
|-
|-
|align=center|MacOS X
|align=center|MacOS X
|[https://www.python.org/downloads/mac-osx/ Download Python here.]
|[https://www.python.org/downloads/mac-osx/ Скачайте Python здесь]
|-
|align=center|Windows
|Necessary only if you need to recompile XSTools for some reason. [https://www.python.org/downloads/windows/ Download Python here]
|}
|}




=== Curl development libraries ===
=== Библиотеки разработки Curl ===
----
----
The Curl development libraries are needed to compile OpenKore. To check whether you have it, type:
У вас должны быть установлены библиотеки разработки '''Curl''' (требуется для компиляции XSTools). Вы можете проверить это командой:


  curl-config --version
  curl-config --version


If you get "command not found" as error message, you need to install libcurl:
Если увидите ошибку "Command 'curl-config' not found", значит библиотеки не установлены. Тогда ознакомьтесь с таблицей ниже:  


{|border="1" cellpadding="2" cellspacing="1"  
{|border="1" cellpadding="2" cellspacing="1"  
|- style=background-color:#F9F9F9;
|- style=background-color:#F9F9F9;
!OS/distribution
!ОС/Дистрибутив
!Instructions
!Примечание
|-
|-
|align=center|Fedora/RHEL/CentOS
|align=center|Ubuntu / Debian
|Open a terminal and type:
|1) найдите доступную версию '''libcurl''': <code>apt-cache search libcurl</code>
su -c 'yum install curl-devel'
2)Установите последнюю версию: <code>su -c 'apt-get install libcurlX-dev'</code>, где 'X' - это номер версии
|-
|-
|align=center|Ubuntu
|align=center|RHEL / Fedora / CentOS
|First, search for the libcurl package using the package manager.
|Откройте терминал и введите: <code>su -c 'yum install curl-devel'</code>
Open a terminal and type:
apt-cache search libcurl
Then install the latest version with this command:
sudo apt-get install libcurlx-dev
Where 'x' is the version number as found by the 'apt-cache search' command.
|-
|-
|align=center|Debian
|align=center|Arch
|First, search for the libcurl package using the package manager.
|Откройте терминал и введите: <code>su -c 'pacman -S curl'</code>
Open a terminal and type:
apt-cache search libcurl
Then install the latest version with this command:
su -c 'apt-get install libcurlx-dev'
Where 'x' is the version number as found by the 'apt-cache search' command.
|-
|-
|align=center|FreeBSD
|align=center|FreeBSD
|Open a terminal and type:
|Откройте терминал и введите: <code>su -c 'pkg_add -r curl'</code>
su -c 'pkg_add -r curl'
|-
|align=center|Arch
|Open a terminal and type:
su -c 'pacman -S curl'
|-
|-
|align=center|Other operating systems or Linux distributions
|align=center|Другие ОС
|Install libcurl from source by downloading it from the [https://curl.haxx.se/ Curl homepage].
|Установите '''libcurl''' из исходников ([https://curl.se/ домашняя страница Curl])
|}
|}


=== Perl module: Win32::Console ===
''(only for Windows Console interface)''


* ActivePerl: Install via <code>ppm</code>.
=== Модуль Perl: Win32::Console ===
* Others: Install via your Perl's package manager or CPAN.
----
''(только для консольного интерфейса Windows)''


== Running OpenKore ==
Команда <code>ppm install Win32::Console</code> или <code>cpan Win32::Console</code>


=== Download ===
== Запуск OpenKore ==
 
=== Загрузка дистрибутива ===
----
----
First, download the OpenKore source code from [[Git|github.com]].
Скачайте дистрибутив OpenKore с [[git|github.com/openkore]].


=== Extract ===
=== Распаковка архива ===
----
----
Extract the archives as instructed on the download page.
Распакуйте архив, как указано на странице загрузки.


=== Run ===
=== Запуск ===
----
----
Open a terminal. Go the OpenKore folder. Type:
Откройте папку с OpenKore и запустите соответствующий файл:
* для Windows: запустите start.exe для запуска [[Console_интерфейс|консольного режима]] или wxstart.exe - для запуска [[Wx_интерфейс|WX-интерфейса]]
* для Linux: откройте терминал и введите: <code>perl ./openkore.pl</code>. Если всё сделади павильно, то OpenKore автоматически попытается скомпилировать XSTools.so (внутреннюю библиотеку). Если компиляция не удалась, проверьте [[Как_запустить_OpenKore#Общие_проблемы|общие проблемы]]. Если вы не нашли решение, то сообщите об ошибке [[git | разработчикам]].


perl ./openkore.pl


And you're done. OpenKore will automatically try to compile XSTools.so, an internally used library. If compilation fails, please check the Common problems. If you still cannot, report the error on our forum.
== [[Аргументы командной строки]] ==
{{:Аргументы_командной_строки}}


== [[Command Line Arguments]] ==
== Общие проблемы ==
{{:Command Line Arguments}}
 
== Common problems ==


=== Missing headers ===
=== Missing headers ===
----
----
Common reason why compilation fails is because of missing headers. Look in the compilation messages. Do you see a message somewhere that looks like this?
Частая причина сбоя компиляции - отсутствие заголовков. Просмотрите вывод консоли при компиляции. Есть ли среди сообщений подобное?


  foo.h: No such file or directory
  foo.h: No such file or directory


If so, then that means you didn't install all the libraries that OpenKore needs! Please go through Preparation again.
Если да, то это означает, что вы не установили необходимые модули\библиотеки. Проверьте [[Как_запустить_OpenKore#Требования|требования]] ещё раз.


==== hash_fun.h ====
==== hash_fun.h ====
----
----
In file included from src/auto/XSTools/utils/perl/Benchmark.xs:1:
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/perl/../dense_hash_map.h:93:66: error: ext/hash_fun.h: No such file or directory


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


  #define HASH_FUN_H <ext/hash_fun.h>
  #define HASH_FUN_H <ext/hash_fun.h>


and replace with:
и змените на:


  #define HASH_FUN_H <backward/hash_fun.h>
  #define HASH_FUN_H <backward/hash_fun.h>
Строка 411: Строка 361:
=== scons: *** SCons version 2.0.1 does not run under Python version 3.2.2. ===
=== scons: *** SCons version 2.0.1 does not run under Python version 3.2.2. ===
----
----
Open the file called Makefile, and replace every
Откройте вызываемый '''Makefile''', изамените везде
 
  python  
  python  
with
на
  python2
  python2
Leave everything else as is. Make sure you have any python-2.x installed if you encounter errors (3.0 is current).
 
Всё остальное оставьте как есть. Убедитесь, что у вас установлен python-2.x, если вы столкнулись подобной ошибкой.


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


Open the file ''src/auto/XSTools/utils/densehashtable.h'' and look for
Откройте файл ''src/auto/XSTools/utils/densehashtable.h'' и найдите:
 
  #include "sparseconfig.h"
  #include "sparseconfig.h"
After that, '''insert''' the following on a new line:
 
после этой строчки вставьте слебующую строчку:
 
  #include <stddef.h>
  #include <stddef.h>
Openkore should compile now.


== Precompiled binaries ==
После этого XSTools должна скомпилироваться.
On Windows, you can use [http://misc.openkore.com precompiled binaries], which contain perl interpreter and all modules and libraries needed.
 
 
== Скомпилированные бинарники ==
Если вы используете Windows, то можете использовать [http://misc.openkore.com готовые бинарники], которые содержат интепритатор perl и все необходимые модули.

Текущая версия от 01:15, 1 февраля 2021

(НЕ) поддерживаемые дистрибутивы 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

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 самостоятельно:
  1. Скачайте исходный код последней версии readline (на момент написания этой статьи была версия: readline-5.1.tar.gz).
  2. Откройте терминал и введите: tar xzvf readline-X.X.tar.gz && cd readline-X.X, где X.X - это версия библиотеки.
  3. Введите ./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 и все необходимые модули.