# 概要

## はじめに

Monaca CLI は、ローカル環境用の開発ツールです。Monaca アプリをローカルで開発するときに使用できます。Monaca CLI では、コマンドライン形式のインターフェイスが提供されています。また、CLI 経由で、ローカル PC から Monaca クラウドのサービスを使用することもできます。Monaca CLI 上では、次の作業を行えます。

* ローカル上でのプロジェクトの新規作成、Monaca クラウド上に保存されたプロジェクトのインポート ( クラウドからローカルへ ) またはクローン。
* お好みのコードエディターを使用した、Monaca

  アプリの開発。お好きなコードエディターを使用して、プロジェクトの作成からビルドまでの工程を、ローカル上で行えるようになります。
* インスペクタを使用した、アプリのデバッグ。
* プロジェクトのコード変換 ( トランスパイル )。コード変換の対象となるプロジェクトは、React.js

  プロジェクト、Angular2 プロジェクトなどです。
* プロジェクトのリモートビルド ( ローカル上での各種セットアップは必要ありません ) 。

## 事前準備

### 要件

Monaca CLI のご利用には、[Node.js](https://nodejs.org/) が必要です ( 事前に、PC にインストールされていること )。

### ステップ 1 : CLI のインストール

次のコマンドを使用して、Monaca CLI をインストールします。

```javascript
$ npm install -g monaca
```

いくつかのシステムでは、インストールする権限が必要になるため、コマンドの前に sudo を追加する必要があります。

```javascript
$ sudo npm install -g monaca
```

{% hint style="info" %}
現在インストールされている Monaca CLI のバージョンを確認する場合には、 `monaca` コマンドを使用します。また、最新の Monaca CLI にアップグレードする場合には、上記のコマンドを使用して、再度、インストールを行います。
{% endhint %}

### ステップ 2 : チュートリアルの確認

Monaca CLI のインストール後は、こちらの [Monaca CLI チュートリアル](/products_guide/monaca_cli/tutorial.md) の内容を参考に、Monaca CLI を使用してみましょう。

## トランスパイル処理 ( コード変換 )

最新の JS フレームワークの中には、JSX などとのやり取りを行うために独自の言語を作成したものや、ネイティブ JavaScript で利用できない拡張機能 ( TypeScriptなど ) を統合したものがあります。トランスパイル処理では、これらの言語で書かれたコードを最新のブラウザ / WebView で実行可能なネイティブ JavaScript コードに変換します。トラインスパイル処理は、WebPack を利用して実行しています。

この処理は、Vue, React, Angular2 テンプレートで実行できます。実行方法は下の 2 つがあります。

1. `monaca transpile`: プロジェクトに対してトランスパイラーを実行します。
2. `monaca preview`: `--watch` オプション付きのプレビューです。このコマンドを実行すると、HTTP サーバーが起動し、アプリのコンテンツを表示してくれます。

## アップロードとダウンロードの制御

特定のファイルやフォルダを除外して Monaca クラウドにアップロードしたくない場合があります。 この場合は、プロジェクトのルートディレクトリにある `.monacaignore` ファイルを編集して、特定のファイルやフォルダを設定することができます。

{% hint style="info" %}
`monacaignore` は、`.gitignore` と同じパターンを使用しています。
{% endhint %}

`.monacaignore` ファイルのデフォルト設定は次のとおりです。

```bash
/.monaca/*
!/.monaca/project_info.json
/platforms
.DS_Store
*.swp
.vscode/
typings/
node_modules
.git
```

参考ページ

* [Monaca CLI コマンド](/products_guide/monaca_cli/cli_commands.md)
* [プロジェクトの構成](/products_guide/monaca_ide/dependencies.md)
* [ペアリングとデバッグ](/products_guide/monaca_cli/pairing_debugging.md)
* [リモートビルドと配布申請](/products_guide/monaca_cli/build_publish.md)
* [トラブルシューティング ガイド](/products_guide/monaca_cli/troubleshooting.md)
* [チュートリアル](/products_guide/monaca_cli/tutorial.md)


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://ja.docs.monaca.io/products_guide/monaca_cli/overview.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.