Moai+Easter ユーザーマニュアル

Moai Manual Advanced Manual Annoucement FAQ
ご案内 インストール ツールの詳細
インストール(PC版) インストール(Android版)

はじめに

ここではMoai PC版の入手およびインストール方法、さらには初回起動までの手順について詳細に解説します.
Android版についてはこちらを参照してください.


目次



Windows版の入手およびインストール方法


インストール手順
最新版はzipファイルとなっており、以下よりダウンロードできます.
32bit Windowsをお使いの方や、どちらを使っていいかよくわからない方は 32bit 版の方をダウンロードしてください.


ダウンロードしましたら次の手順でインストールします.

  1. ダウンロードしたzipファイルを展開します.
    znk_project というフォルダを一つ作り、その中にこのzipファイルを展開することをお勧めします.
    znk_project に属する他のアプリもこの中にまとめて置いておいた方が見通しがよくなるためです.

    展開直後の時点での全体のサイズ合計はせいぜい15MB程度なのですが、将来に備えてディスク容量にさらに150MB程度の余裕がある方が望ましいです.
    詳細はこちらを参照してください.

  2. 展開フォルダの中に moai.exe があることを確認してください(これが実行ファイル本体となります).
    これを実行します.

  3. 展開フォルダと同列の場所に moai_profile フォルダが作成されたことを念のため確認してください
インストールについては以上です.

moai.exeへのショートカットをデスクトップ等に作っておくと便利です.
尚、Moaiではレジストリ等の書き込みは一切行われません.
Moaiを明示的に終了させる必要性は通常ありませんが、終了させたい場合はMoaiのウィンドウを閉じましょう.



セキュリティの重要な警告ダイアログについて
Moaiの初回起動時、Windowsのファイアウォール機能により、以下のダイアログが表示されることがあります.

外部マシンからのアクセスを許すサーバ機能を持つアプリケーションを起動した場合、Windowsファイアウォールはこの確認ダイアログを出します.
プログラムのソースコード的に言えば INADDR_ANYを指定してWinSock2 APIでのbind を実行した場合となります.





この場合「ブロックしない」あるいは「アクセスを許可」等を選んでおくとよいでしょう.
また仮に「ブロックする」や「キャンセル」を選んでも、このツールをローカルマシンでのみ使う分には特に支障ありません.
( Moaiを他のLAN上のマシンなどから経由して利用をしたいという「あまり普通ではない使い方」をしたい場合は、このブロックを解除する必要があるかもしれません. )



Windows起動時にバックグラウンドでMoaiを自動起動させる方法
Windows起動時に毎回Moaiを起動しても別にたいした手間ではないし、その方がMoaiが起動中であることがわかりやすいと思います.
しかし、あなたがもしその手間を省きたいならMoaiをWindowsのスタートアップに登録する方法があります.
方法は簡単でmoai.exeへのショートカットを作り、これをあなたのWindowsの「スタートアップ」フォルダにコピーするだけです.
Windowsを再起動してみて、Moaiが自動的に起動するなら成功です.

また、コマンドプロンプト上から以下のように実行するとコンソールウィンドウを表示させずにMoaiを起動することができます.

start /MIN moai.exe

付属するmoai_without_console.bat はこれを実行するものです.
このショートカットをスタートアップフォルダにコピーすれば、見かけ上はWindowsサービスと同じくWindows起動時にバックグラウンドで自動起動するような感じになるでしょう.

それならもうMoaiをWindowsサービスにしてしまえば?と思われる方もいるかもしれません.
WindowsサービスとはWindowsを起動したときに自動的に起動し、その後明示的に停止しない限りはずっとバックグラウンドで動作するというものです.

しかしMoaiではこれはサポートしていません.
Windowsサービスとして起動させるためにはそれ用に特別な実装をしなければなりません.
また、レジストリへの登録も発生しますから、アンインストーラも考慮しなければならなくなります.
そしてそのようにしてシステムを複雑化させた代償の割に得られるものも少ないと思うからです.



アンインストールについて
Moaiをアンインストールするには展開フォルダをそのまま削除すればよいです.
ただし基本的にmoai_profileフォルダだけは削除せず残しておく方がよいでしょう.
これについては、moai_profileを参照してください.


目次に戻る

Linux版の入手およびインストール方法


インストール手順
最新版はzipファイルとなっており、以下よりダウンロードできます.
64bit Linux で 32bit版Moaiを動作させることも可能ではありますが、場合によってはそのための環境を配備する必要があるかもしれません.
お使いのLinuxが64bit版なのか32bit版なのかを確認し、合致する方をダウンロードした方が確実でしょう.
どちらのLinuxをお使いであるかわからない場合は unameコマンドなどで確認できるかと思います.
ただ昨今のPC版Linuxは64bitと考えてほぼ間違いないとは思います.


ダウンロードしましたら次の手順でインストールします.
以下では64bit Linuxと仮定して説明します.

  1. ダウンロードしたzipファイルを展開します.
    unzipコマンドを使うとよいでしょう( Command not foundと表示される場合はこれをLinuxにインストールしておきましょう ).

    展開直後の時点での全体のサイズ合計はせいぜい15MB程度なのですが、将来に備えてディスク容量にさらに150MB程度の余裕がある方が望ましいです.
    詳細はこちらを参照してください.

  2. 展開したディレクトリへ移動します.
    以下のように入力しEnterを押します.

    cd moai-v2.2-linux64

  3. moaiを一旦起動させます.
    以下のように入力しEnterを押します.

    sh moai_for_linux.sh

    尚、2度目以降の起動は、もちろん上記のように入力してもかまいませんが、 単に以下のように入力しても起動できると思います.

    ./moai

  4. 展開ディレクトリと同列の場所に moai_profile ディレクトリが作成されたことを念のため確認してください
インストールについては以上です.

Moaiを明示的に終了させる必要性は通常ありませんが、終了させたい場合はCtrl+Cでプロセスをkillして構いません.



アンインストールについて
Moaiをアンインストールするには展開ディレクトリをそのまま削除すればよいです.
ただし基本的にmoai_profileディレクトリだけは削除せず残しておく方がよいでしょう.
これについては、moai_profileを参照してください.


目次に戻る

Cygwin版の入手およびインストール方法


インストール手順
最新版はzipファイルとなっており、以下よりダウンロードできます.
64bit Windows の方もこれをお使いください.


Cygwinの64bit版専用実行バイナリは提供しておりません.
(Cygwin環境本体がWOWで動作する32bitというケースもあり得るため、このあたりの組み合わせは割と煩雑です).

そもそもWindows版がある中、わざわざCygwin版を選ぶといった方はソースコードから自分でビルドして使いたいという方がほとんどだと思います.
従って、わざわざ実行バイナリを提供する意味自体あまり感じないのですが、その場合でもビルド後の構成がどうなっているのかは確認できますので、
32bit版実行バイナリのみ提供しております.

ダウンロードしましたら次の手順でインストールします.
基本的にはLinuxにおける手順に準じます.

  1. ダウンロードしたzipファイルを展開します.
    unzipコマンドを使うとよいでしょう( Command not foundと表示される場合はマウスクリックして展開してしまってもよいでしょう ).

    展開直後の時点での全体のサイズ合計はせいぜい15MB程度なのですが、将来に備えてディスク容量にさらに150MB程度の余裕がある方が望ましいです.
    詳細はこちらを参照してください.

  2. 展開したディレクトリへ移動します.
    以下のように入力しEnterを押します.

    cd moai-v2.2-cygwin32

  3. moaiを一旦起動させます.
    以下のように入力しEnterを押します.

    sh moai_for_cygwin.sh

    尚、2度目以降の起動は、もちろん上記のように入力してもかまいませんが、 単に以下のように入力しても起動できると思います.

    ./moai

  4. 展開ディレクトリと同列の場所に moai_profile ディレクトリが作成されたことを念のため確認してください
インストールについては以上です.

Moaiを明示的に終了させる必要性は通常ありませんが、終了させたい場合はCtrl+Cでプロセスをkillして構いません.



アンインストールについて
Moaiをアンインストールするには展開ディレクトリをそのまま削除すればよいです.
ただし基本的にmoai_profileディレクトリだけは削除せず残しておく方がよいでしょう.
これについては、moai_profileを参照してください.


目次に戻る

moai_profile


moai_profileとは?
moai_profile とは Moai 本体のディレクトリとは独立した特別なディレクトリです(ここではフォルダのこともディレクトリと呼びます).
moai_profile には、Moai+Easterでのブックマークやコレクション機能で集めた画像や動画ファイルの実体などが格納されます.
新しく作成された直後の moai_profile の中身はほとんど空っぽですが、
コレクション機能をご利用になる場合は収集した画像や動画分、moai_profileの中身のサイズが増えていくと思います.
このサイズの上限設定などは特に設けておりません.

また、将来新しいMoai+Easterがリリースされて本体をバージョンアップするようなことがあったとしても、
基本的にmoai_profileだけは共通で維持し、そのまま次バージョンに引き継ぐ形になります.
つまり moai_profile はMoai+Easter本体のバージョンからも独立した存在であることに注意してください.



Moaiが不要になった場合、このmoai_profileも削除してよいのか?
Moai 本体が不要になっても、普通は集めた画像や動画は残しておきたいでしょう.
よって Moai 本体のディレクトリを削除しても moai_profile だけは残しておくべきです.
(必要に応じて中身をサルベージするなどもできるでしょう).
しかし、それらの画像や動画さえも不要というなら、moai_profile もまるごと削除してもかまいません.



moai_profile の位置は?
初期設定では、Moai本体より一つ上のディレクトリになっています.
moai_profile がまだ存在しない場合、Moai はこの位置へ moai_profile を自動的に生成します.

moai_profile の位置は Moaiエンジンの設定画面で変えることができます.
例えば現在のディスク容量に余裕がなく、moai_profile のみを他のディスクに移動させたい場合などに柔軟に対応できます.
この位置は、環境変数 MOAI_PROFILE_DIR の値としてそのフルパスを設定することで強制的に指定することもでき、
これが指定されている場合は Moaiエンジンの設定よりもこれが優先されます.


目次に戻る

Moai+Easter本体が使うディスク容量について

Moai+Easterでは、展開直後の時点での全体のサイズ(15MB程度)に加え、
実際にはここからさらにログファイルやキャッシュファイルなどの一時ファイル群が作成されます.
従ってその分、ディスク容量の余裕を見ておく必要があります.

特にEasterは一般のブラウザと同じようにサイト閲覧時にキャッシュファイル作成機能を有します.
これらはある程度の日数期間保存されるもので、閲覧頻度によっては最大で合計150MB以上にもなる場合があります.
今時の大容量ディスクならさほど問題になるサイズではないとは思いますが、一応この点了承ください.

ちなみにこの保存日数は設定で変更することもでき、日数を短くすればその分サイズを減らすことも可能ですが、
サイズの上限を(MB単位で)直接指定することは現バージョンのEasterではできません.

目次に戻る

This article was written by:
none image

Mr.Moai

@znk project