Ionicは英語のドキュメントがしっかりしている上にコミュニティもある程度大きいので、英語さえ読めればわからないことがあっても大抵解決します。ただ日本語の記事となると、情報が古かったりほんのさわりだけしかやってなくて本格的に使う際に知りたいことなんかはあまりない印象があります。ということでこの記事ではIonicで開発を進める際に知っておかないといけないことを順不同でまとめていきます。情報は随時更新していく予定です。

Ionicのパッケージマネージャーとしてnpmではなくてyarnを使う

Ionicはパッケージマネージャーとしてデフォルトではnpmを使用しますが、これをyarnに切り替えることができます。すべてのプロジェクトのデフォルトでyarnを使用したい場合は
ionic config set -g yarn true
で切り替わります。 また、yarnを含めたIonicのグローバルな設定は ~/.ionic/config.json で定義されています。これがデフォルトの設定となります。この内容は
ionic config get -g
で確認することができます。変更したい場合は上記のように set を使用します。 プロジェクト単位の設定は各プロジェクトのルートに入っているionic.config.jsonです。ionicでCLIを走らせると、グローバルな~/.ionic/config.jsonの設定をionic.config.jsonで上書きすることになります。なので、デフォルトはnpmであるプロジェクト内でのみyarnを使用したい場合は、プロジェクトディレクトリ内で
ionic config set yarn true
とすることで、そのプロジェクト内でのみyarnを使用することができます。

参考ページ

Ionicのソースコード内で開発環境と本番環境を切り替える

IonicがベースにしているAngularではng newすると、開発環境と本番環境を切り替えるためのsrc/environments/environment.tsとsrc/environments/environments.prod.tsがもれなくついてきますが、Ionicでionic startしてもsrc/environmentsはついてきません。Ionicでこれらのファイルで環境を切り替えられるようにするには、webpackの設定に少しだけ手を加えます。 まずはプロジェクトディレクトリのルートへ移動し、node_modules/@ionicからwebpack.config.jsをコピーしてきます。
cp node_modules/\@ionic/app-scripts/config/webpack.config.js ./
コピー元のファイルがIonicがデフォルトで使用しているwebpack用のconfigファイルです。コピーしてきた中身を以下のように書き換えます。 やっていることは単純で、デフォルトのwebpack.config.jsを読み込んだ後、alias@app/environmentを追加しています。aliasが示す先はこれから作るsrc/environments以下の環境設定用ファイルです。 コードの中にprocess.env.IONIC_ENVというのがありますが、これはIonicが、というかIonic App ScriptがNodeのprocess.envにセットしてくれているプロパティの一つです。その他のプロパティの一覧はGithubページに載っています。 次はpackage.jsonの変更です。コピーしてきたwebpack.config.jsをIonicに教えるためにpackage.jsonに以下を追加します。 これでwebpack.config.jsの読み込み元を上書きしてくれます。 tsconfig.jsonも修正する必要があります。プロジェクトのトップディレクトリにあるtsconfig.jsonのcompilerOptionsに以下を付け加えます 最後にenvironmentファイルを作成します。以下の2つのファイルをsrc/environmentsにつくってください。中身はAngularのCLIでng newしたときに作られるファイルそのものです。 以上で準備完了です。あとはionic servenpm run ionic:serveして、好きなところで するとenviornment.productiontrue/falseにセットされているのが確認できます。

importで相対パスではなくエイリアスを使う

importする際に相対パスでやってると後々大変なことになるので、エイリアスを使えるようにしましょう。Ionicでimportのエイリアスを追加するには、webpackの設定ファイルとTypeScriptの設定ファイルを両方いじる必要があります。なのでまずは「Ionicのソースコード内で開発環境と本番環境を切り替える」の手順にしたがって、webpack.config.jsonを用意します。そしてそこに のようにaliasに1行加えます。'@'の部分がそれです。 次はTypeScriptの設定に手を加えます。プロジェクトのトップディレクトリにあるtsconfig.jsonのcompilerOptionsに以下を付け加えます 設定は以上です。これで のようにsrcディレクトリを起点としたモジュールの読み込みができるようになります。

どちらかに追加し忘れた場合のエラー内容

ちなみに、webpackの方にエイリアスを追加して、tsconfig.jsonにパスを追加するのを忘れると
Typescript Error
Cannot find name 'SomeService'.
というようにTypeScriptでエラーが出ます。逆にtsconfig.jsonにパスを追加してwebpack.config.jsonにエイリアスを追加するのを忘れるとランタイムエラー
Runtime Error
Uncaught (in promise): Error: Cannot find module "@/app/core/services/some-service" ...
で怒られてしまいます。

Angular CLIを使ったAngularアプリの場合

この手順はAngularでも同様です。Angularの場合はng newしただけではwebpack.config.jsは存在しませんが、ng ejectすることでトップディレクトリにwebpack.config.jsを吐き出すことができます。これとtsconfig.jsonに上記の項目を追加すると同じようにモジュールの読み込みにエイリアスを使うことができます。

参考ページ

gshigeto/ionic-environment-variables: Easy to use environment variables for Ionic3! Environment variables in Ionic 2 | b-nova