Monaca Localkitでプロジェクトが登録されないときの解決方法

概要

Monaca LocalkitMonacaが提供するローカル開発支援ツールです。Localkitを使うとVSCodeやAtomなどお気に入りのエディタを使って開発することができます。

本記事ではLocalkitで新しいプロジェクトを作成しようとしてもプロジェクト一覧に登録されずLocalkitが使えない場合の解決方法について説明します。

環境

  • 開発環境:Windows10
  • Git for Windowsをインストール

症状

  • プロジェクトの作成ボタンを押すと、作成処理の終了時にメッセージのないメッセージボックスが表示される(下記画像)
  • メイン画面に戻ってみるとプロジェクト一覧に登録されていない
  • 指定した場所にフォルダやファイルは作成されている

前提条件

Monaca公式ドキュメントから引用します。

Windows 環境で Localkit を利用する場合は、事前に Git をインストールする必要があります。

https://docs.monaca.io/ja/products_guide/monaca_localkit/overview/#インストールと設定

また、最新版のLocalkit(v3.3.0)では、起動時にGitのインストールが必要であることを通知するダイアログが表示されます。

GitはGit for Windowsのサイトからダウンロードできます。ダウンロードした後、Web上の情報などを参考にインストールします。(インストーラの選択肢のなかで「 Use Git from the Windows Command Prompt 」を選択した場合は本記事のような現象は発生しないようです)

ログの確認

Git for Windowsをインストールした状態でLocalkitを起動します。問題なく立ち上がるのですが、プロジェクトを作成しようとすると、先に示したようにメッセージのないメッセージボックスが表示され、プロジェクトが登録されません。

このときログを出力してみるとエラーが発生していました。ログの内容を以下に示します。(ログはLocalkitのメニューから[ファイル] – [設定]を選択して表示される設定画面で、[ログ出力]に指定したファイルに保存されます)

2019-01-19T17:32:39	Creating Project:C:\Users\OWNER\Documents\work\study\Monaca\project\test01 https://github.com/monaca-templates/onsenui-v2-js-minimum/archive/master.zip
2019-01-19T17:32:39	
Downloading template...

2019-01-19T17:32:45	[www] Inserting components...
2019-01-19T17:32:45	Installing template dependencies...

2019-01-19T17:32:58	npm WARN
2019-01-19T17:32:58	 deprecated node-uuid@1.4.8: Use uuid module instead

2019-01-19T17:33:08	npm WARN deprecated
2019-01-19T17:33:08	 hoek@2.16.3: The major version is no longer supported. Please update to 4.x or newer

2019-01-19T17:33:13	npm ERR! code
2019-01-19T17:33:13	 ENOGIT

2019-01-19T17:33:13	npm ERR! Error while executing:
npm ERR! undefined ls-remote -h -t ssh://git@github.com/xiangpingmeng/plist.js.git
npm ERR! 
npm ERR! undefined
npm ERR! No git binary found in $PATH
npm ERR! 
npm ERR! Failed using git.
npm ERR! Please check if you have git installed and in your PATH.

2019-01-19T17:33:13	
npm ERR!
2019-01-19T17:33:13	 A complete log of this run can be found in:
npm ERR!     C:\Users\OWNER\AppData\Roaming\npm-cache\_logs\2019-01-19T08_33_13_109Z-debug.log

2019-01-19T17:33:13	[Error] Error in creating a project

24行目をみると「gitがインストールされていてPATHに入っているか確認してください。」とあります。Gitはインストール済みなので問題はPATHのほうにあるようです。

解決方法

上記のエラー内容に従いPATHを設定します。PATHは環境変数の一つで、実行ファイル(.exe)を起動したときに参照されるパスを格納しています。ここにgit.exeファイルへのパスを追加します。

以下にPATHの設定方法の一例を示します。

1.エクスプローラで[PC]を右クリックし、ポップアップメニューから[プロパティ]を選択

2.[システムの詳細設定]をクリック

3.[詳細設定]タブの[環境変数]ボタンをクリック

4.[Path]欄をダブルクリック

5.git.exeへのパス[C:\Program Files\Git\cmd]を追加し、[OK]ボタンを押す

6.各画面で[OK]ボタンを押してウィンドウを全て閉じる

PATH設定後、Localkitを再起動してプロジェクトを作ってみると無事登録されました。(パソコンの再起動は必要ないようです)