Skip to content

Latest commit

 

History

History
157 lines (100 loc) · 6.2 KB

SETUP.md

File metadata and controls

157 lines (100 loc) · 6.2 KB
Raw

なでしこ3 - 開発環境のセットアップ方法

js-standard-style

なでしこ3自身を開発する手順をまとめたもの。なでしこ3を使うだけならば、次の手順は不要。

Node.jsをインストールしておく。

コマンドラインから以下を実行して、必要なライブラリをシステムにインストール。

このとき、npm installするときに、なでしこのモジュールで、Native Add-onを使うものがあるため、ビルド環境を整える必要がある。

【Windows】

コンパイル環境が必要になるので、ビルドツールをインストールする。PowerShellから次のコマンドを実行すると、自動的に必要なツールが入る。(Windowsのユーザー名に日本語が使われているとうまくコンパイルできないという情報もあるので注意)

また、Gitなどのツールをインストールするために、Chocolateyをインストールしておく。

# Chocolatey でGitをインストール
cinst git

# npm のビルドツール (build tools+python2)
npm install -g node-gyp
npm install -g windows-build-tools

【macOS】

Homebrewをインストールしておく。

【共通】

コマンドラインから以下を実行して、nadesiko3のリポジトリをcloneし、必要なライブラリをインストール。ただし、Node.jsのバージョンv10以上が必要。もし、Ubuntuで古いのNode.jsをインストールした場合などは最新安定版のNode.jsを利用してください。

なお、gitでリポジトリを取得する際、サブモジュールを利用するので、--recursiveを指定するのを忘れないようにしましょう。

git clone --recursive https://github.com/kujirahand/nadesiko3.git
cd nadesiko3
npm install --no-optional

コマンドラインから次のコマンドを実行することで、ソースコードをビルドできる。 srcディレクトリの中のコードを編集すると、releaseディレクトリに結果が出力される。

# Node.js用のソースコードをWeb用のJSに変換
npm run build

ビルド後に次のコマンドを実行することで、 バンドルファイル内の各パッケージがどのぐらいの容量を占めているかを可視化できる。

# バンドルファイル内の各パッケージがどのぐらいの容量を占めているかを可視化
npm run analyze

開発時、次のコマンドを実行すれば、監視ビルドさせることができる。

npm run watch

また、コマンドラインから次のコマンドを実行することで、ソースコードをテストできる。

npm run test

開発時の約束

コーディング規約について

コーディング規約は、JavaScript Standard Styleに準拠するものとする。

ATOMエディタを使っている場合は、次のプラグインを導入すると非常に便利。

apm install linter
apm install linter-js-standard

また、EditorConfigに対応している。 (詳しくはどんなエディタでもEditorConfigを使ってコードの統一性を高める - Qiitaを参照) これに対応したエディタを使用することで、開発者側が意識することなくインデントやタブに関する規則に対応することが可能。

コマンドラインからなでしこを使う方法

なでしこ3ではコマンドラインからなでしこを実行できるcnako3(Windowsは、cnako3.bat)というスクリプトを用意。今後、なでしこの各種バッチファイルはなでしこ自身で記述される。

ちなみに、npm install -g nadeisko3 を実行すると、npmコマンドでcnako3コマンドが利用できるようになるが、その場合は安定版のなでしこがインストールされることになる。

環境変数に本ファイルのパスをNAKO_HOMEとして登録し、パスをNAKO_HOME/srcに通す。以下、macOS/Linuxでの .bashrc の記述例。(ユーザー名がkujiraの場合)

HOME=/Users/kujira
export NAKO_HOME=$HOME/nadesiko3
export PATH=$PATH:$NAKO_HOME/src

コマンドライン版なでしこの利用方法

例えば、なでしこのコマンド一覧ファイルを生成するバッチを実行する方法。

cnako3 $NAKO_HOME/batch/pickup_command.nako

テストを実行する場合には、 -t (--test) オプションを付けてcnako3を実行します。

デモプログラムを動かす方法

demoディレクトリに、なでしこをブラウザから使うデモがある。

大抵の機能はブラウザにHTMLファイルをドラッグ&ドロップすれば動くが、一部の機能はローカルサーバーを動かさないと利用できない。

なでしこでは、簡易サーバーを用意。コマンドラインで次のように入力すると、http://localhost:3000/でサーバーが起動。

npm start

対応機器/ブラウザの生成

コマンドラインから以下を実行して、次のファイルを生成。

npm run build:browsers

Node.jsのパッケージの更新方法

コマンドラインから以下を実行して、Node.jsのパッケージを更新。

npx npm-check-updates -u
npm update --no-optional

Gitからリポジトリを取得して利用する場合

最低限のライブラリで良い場合には、npm install --productionを実行するだけ。

git clone --recursive https://github.com/kujirahand/nadesiko3.git
cd nadesiko3
npm install --production

(メモ)Electronの利用に関して

以前は、本リポジトリでElectronにも対応していたが別リポジトリを用意した。

なでしこ3配布パック(Electron)