Quick search

 

Table Of Contents

Installation(翻訳済み)

私たちは車輪の再発明はしないですが、市場に何かイノベーションを持ち込もうとしています。結果として、我々は自身のコードにフォーカスして可能な場合は既存の高品質のサードパーティライブラリを使用しています。Kivyが提供する豊富な機能全てをサポートするために、いくつかの他のライブラリが必要です。特定の機能（例：ビデオ再生）を使用しない場合は、該当する依存関係は必要ありません。とは言うものの、Kivyが必要 な依存関係は Cython があります 。

This version of Kivy requires at least Cython version 0.23, and has been tested through 0.25.2. Later versions may work, but as they have not been tested there is no guarantee.

Python 2.xの（2.7 <= xと<3.0）または3.xの（3.3 <= x）の変換を必要とします。ウィンドウ（例：ウィンドウオープン）などの機能を有効にする場合は、オーディオ/ビデオの再生やスペル訂正、追加の依存関係が使用可能でなければなりません。これらのために、 SDL2 、 Gstreamer 1.x と PyEnchant をそれぞれお勧めします。

他の任意のライブラリ（互いに独立している）は、次のとおりです:

そうは言うものの、 慌てる必要はありません ！

私たちは、自分でそれらのすべてをインストールすることを期待してません。その代わりに、私たちはすでに使用しているプラ​​ットフォームの必要なパッケージが含まれていて直接使用できる素敵なポータブルパッケージを作成しています。私たちはKivyが内部で使用するものの概要を与えるのと、デフォルトに選択肢があることを知ってもらいたいです。

Stable Version(安定版)

最新の安定バージョンは、Kivyのウェブサイト上（http://kivy.org/#download）で見つけられます 。特定のプラットフォーム用のインストール手順を参照してください。

Development Version(開発版)

開発版は、開発者とテスターのためのものです。開発版を実行している際は、自分自身のリスクで、潜在的に壊れたコードを実行していることに注意してください。開発版を使用するには、まず依存関係をインストールする必要があります。その後、簡単に開発できる方法でコンピュータにKivyを設定する必要があります。 Contributing(翻訳済み) を参照してください。

Installing Dependencies(依存関係のインストール)

ivyの依存関係をインストールする際は、ご使用のプラットフォームごとに以下のガイドに従ってください。RSTコンポーネントとレキシングコンポーネントには、これらのパッケージが必要な場合もあります:

$ sudo pip install pygments docutils

Ubuntu

Ubuntuの12.04と、より上（14.04までテスト済み）についてはすべての必要なパッケージをインストールする次のシンプルなコマンドを入力します。

$ sudo apt-get install python-setuptools python-pygame python-opengl \
  python-gst0.10 python-enchant gstreamer0.10-plugins-good python-dev \
  build-essential libgl1-mesa-dev-lts-quantal libgles2-mesa-dev-lts-quantal\
  python-pip

Ubuntuの15.04と12.04よりも古いバージョンでは、以下が動作するはずです:

$ sudo apt-get install python-setuptools python-pygame python-opengl \
  python-gst0.10 python-enchant gstreamer0.10-plugins-good python-dev \
  build-essential libgl1-mesa-dev libgles2-mesa-dev zlib1g-dev python-pip

KivyはCythonの最新バージョンを必要とするので、PyPIから提供される最新バージョンを使用することをお勧めします:

$ sudo pip install --upgrade Cython==0.25.2

OS X

Homebrew を使用せずに、ターミナルに次のコマンドを貼り付けることで、手動でkivyの依存関係をインストールできます:

curl -O -L https://www.libsdl.org/release/SDL2-2.0.4.dmg
curl -O -L https://www.libsdl.org/projects/SDL_image/release/SDL2_image-2.0.1.dmg
curl -O -L https://www.libsdl.org/projects/SDL_mixer/release/SDL2_mixer-2.0.1.dmg
curl -O -L https://www.libsdl.org/projects/SDL_ttf/release/SDL2_ttf-2.0.13.dmg
curl -O -L http://gstreamer.freedesktop.org/data/pkg/osx/1.7.1/gstreamer-1.0-1.7.1-x86_64.pkg
curl -O -L http://gstreamer.freedesktop.org/data/pkg/osx/1.7.1/gstreamer-1.0-devel-1.7.1-x86_64.pkg
hdiutil attach SDL2-2.0.4.dmg
sudo cp -a /Volumes/SDL2/SDL2.framework /Library/Frameworks/

これはrootパスワードを要求されて、パスワードを入力してからターミナルに次の行を貼り付ける必要があります:

hdiutil attach SDL2_image-2.0.1.dmg
sudo cp -a /Volumes/SDL2_image/SDL2_image.framework /Library/Frameworks/
hdiutil attach SDL2_ttf-2.0.13.dmg
sudo cp -a /Volumes/SDL2_ttf/SDL2_ttf.framework /Library/Frameworks/
hdiutil attach SDL2_mixer-2.0.1.dmg
sudo cp -a /Volumes/SDL2_mixer/SDL2_mixer.framework /Library/Frameworks/
sudo installer -package gstreamer-1.0-1.7.1-x86_64.pkg -target /
sudo installer -package gstreamer-1.0-devel-1.7.1-x86_64.pkg -target /
pip install --upgrade --user cython pillow

今、kivyのすべての依存関係が持っていることをコマンドラインツールでインストールされていることを確認する必要があります:

xcode-select --install

以下のように適切なディレクトリに移動します：

mkdir ~/code
cd ~/code

kivyをインストールできます:

git clone http://github.com/kivy/kivy
cd kivy
make

これは、pythonのENVでアクセス可能なだけで、このディレクトリにPYTHONPATHを指すようにするために、kivyをコンパイルする必要があります:

export PYTHONPATH=~/code/kivy:$PYTHONPATH

kivyがインストールされているかどうかを確認するには、ターミナルで次のコマンドを入力します:

python -c "import kivy"

次のような出力を表示します:

$ python -c "import kivy"
[INFO   ] [Logger      ] Record log in /Users/quanon/.kivy/logs/kivy_15-12-31_21.txt
[INFO   ] [Screen      ] Apply screen settings for Motorola Droid 2
[INFO   ] [Screen      ] size=480x854 dpi=240 density=1.5 orientation=portrait
[INFO   ] [Kivy        ] v1.9.1-stable
[INFO   ] [Python      ] v2.7.10 (default, Oct 23 2015, 18:05:06)
[GCC 4.2.1 Compatible Apple LLVM 7.0.0 (clang-700.0.59.5)]

OSX HomeBrew

homebrewを使用する場合: homebrew を使用して必要条件をインストールします:

$ brew install sdl2 sdl2_image sdl2_ttf sdl2_mixer gstreamer

Installing Kivy for Development(Kivyの開発版をインストール)

現在すべての必要な依存関係をインストールしているのでKivyの開発版をダウンロードしてコンパイルしてみましょう:

GitHubからKivyをダウンロードします:

$ git clone git://github.com/kivy/kivy.git
$ cd kivy

コンパイルします:

$ python setup.py build_ext --inplace -f

make コマンドが利用可能な場合、（最後のコマンドと同じこと）をコンパイルするには、次のショートカットを使用できます:

$ make

警告

デフォルトでは、Python 2.7 と2.7.2には、XCodeの以前のバージョンに付属のgccコンパイラを使用します。 これはXCodeの4.2以上を使用してコンパイルした場合、少なくともPythonの2.7.3がインストールされていることが好ましく、または最新バージョン（執筆時点では2.7.5）をインストールする必要があることを意味します。

Kivyコード自体を変更したい場合は、 環境変数PYTHONPATH をあなたのクローンを指すように設定します。この方法は些細なすべての変更後にインストールする必要はありません（setup.pyをインストール）。Pythonからではなく、クローンからKivyをインポートします:

Kivy自身に任意の変更を行いたくない場合は、別の方法（例えばadmin権限でsudo）を実行できます。

$ python setup.py install

If you want to contribute code (patches, new features) to the Kivy codebase, please read Contributing(翻訳済み).

Running the test suite(テストスイートを実行する)

Kivyの問題と動作の変更を検出しやすくするために、ユニットテストのセットが提供されています。テストを実行するのに良いときはKivyのインストール後にそれらを実行する事と変更をプッシュするすべての時です。Kivyで何かが壊れていると考えられる場合は、おそらくテストにはその旨が表示されます。（そうでない場合は、書き込むのに良い時かもしれません。）

Kivyのテストnosetestに基づいていて、パッケージマネージャまたはpipを使用してインストールできます:

$ pip install nose

テストスイートを実行するには、以下を実行します:

$ make test

Uninstalling Kivy(Kivyをアンインストール)

複数のKivyインストールを混合している場合は、それぞれのKivyバージョンがどこにあるかについて混乱している可能性があります。Pythonライブラリのパスにインストールされている複数のKivyバージョンがある場合はこれらのステップを複数回実行する必要があるかもしれないことに注意してください。現在インストールされているバージョンを確認するには、コマンドラインを使用できます:

$ python -c 'import kivy; print(kivy.__path__)'

そして再帰的にそのディレクトリを削除します。

Linux上でeasy_installでKivyをインストールした場合、ディレクトリは「egg」ディレクトリが含まれていてもよいです:

$ python -c 'import kivy; print(kivy.__path__)'
['/usr/local/lib/python2.7/dist-packages/Kivy-1.0.7-py2.7-linux-x86_64.egg/kivy']
$ sudo rm -rf /usr/local/lib/python2.7/dist-packages/Kivy-1.0.7-py2.7-linux-x86_64.egg

apt-getでインストールしている場合は、以下を実行します:

$ sudo apt-get remove --purge python-kivy
« User’s Guide(翻訳済み) Installation on Windows(翻訳済み) »