安裝
請確保安裝了最新的Node 6 LTS和NPM 3+
然后,全局安裝CLI(您可能需要sudo)
$ npm install -g ionic@latest
您可以使用該ionic --version命令驗證安裝帝牡。
入門
使用ionic start以下方法啟動新的Ionic項目紫新;
$ ionic start myNewProject
選擇啟動器后令哟,CLI將創(chuàng)建一個名為的新應(yīng)用程序myNewProject袖外。一旦你cd進入你的項目目錄,一些新的命令變?yōu)榭捎妹喙溃鏸onic serve:
$ cd ./myNewProject
$ ionic serve
運行時ionic serve
炎疆,您對應(yīng)用代碼所做的更改將自動刷新瀏覽器。如果要在設(shè)備或模擬器上查看應(yīng)用程序国裳,可以使用Cordova形入。
您可以使用該ionic --help命令列出可用命令。
使用Cordova
將Ionic與Cordova集成缝左,為您的應(yīng)用程序帶來原生功能亿遂。
$ npm install -g cordova
$ ionic cordova --help
$ ionic cordova run ios
故障排除
確保您使用的是最新版本的CLI。用npm update -g ionic盒使。更新崩掘。
配置文件
配置值存儲在JSON文件中。
- 全局配置文件(~/.ionic/config.json):用于全局CLI配置和身份驗證
- 項目配置文件(ionic.config.json):用于離子項目配置
CLI提供了用于從項目配置文件和全局CLI配置文件設(shè)置和打印配置值的命令少办。查看ionic config set --help和ionic config get --help使用苞慢。
環(huán)境變量
CLI將查找以下環(huán)境變量:
- IONIC_CONFIG_DIRECTORY:全局CLI配置的目錄。默認為~/.ionic英妓。
-
IONIC_HTTP_PROXY
:設(shè)置用于代理所有CLI請求的URL挽放。請參閱使用代理。CLI也會查找
HTTP_PROXY和HTTPS_PROXY使用npm蔓纠。 - IONIC_EMAIL/ IONIC_PASSWORD:用于通過環(huán)境變量自動登錄辑畦。
服務(wù)代理
CLI可以將代理添加到HTTP服務(wù)器以獲取“l(fā)ivereload”命令,例如ionic serve和ionic cordova run android -lc腿倚。如果您在瀏覽器中進行開發(fā)并且需要調(diào)用外部API纯出,則這些代理非常有用。使用此功能敷燎,您可以通過Ionic CLI將請求代理到外部API暂筝,從而防止出現(xiàn)No 'Access-Control-Allow-Origin' header is present on the requested resource錯誤。
在ionic.config.json文件中硬贯,您可以添加包含要添加的代理數(shù)組的屬性焕襟。代理是具有以下屬性的對象:
- path:將與傳入請求URL的開頭匹配的字符串。
- proxyUrl:一個字符串饭豹,其中包含代理請求應(yīng)該去的URL鸵赖。
-
xyNoAgent
:(可選)true / false,如果true選擇了連接池拄衰,請參閱HttpAgent
{
"name": "appname",
"app_id": "",
"type": "ionic-angular",
"proxies": [
{
"path": "/v1",
"proxyUrl": "https://api.instagram.com/v1"
}
]
}
使用上面的配置它褪,您現(xiàn)在可以向本地服務(wù)器http://localhost:8100/v1發(fā)出請求,讓它代理請求https://api.instagram.com/v1肾砂。
注意:不要忘記將應(yīng)用中請求的網(wǎng)址更改為本地網(wǎng)址列赎。此外,必須重新啟動“l(fā)ivereload”命令才能使代理配置生效。
使用代理
要代理CLI執(zhí)行的HTTP請求包吝,您需要在與node_modulesIonic CLI 相同的上下文中安裝CLI代理插件:
對于全局安裝的CLI:
$ npm install -g @ionic/cli-plugin-proxy
對于本地安裝的CLI:
$ cd myProject # cd into your project's directory
$ npm install --save-exact --save-dev @ionic/cli-plugin-proxy
然后饼煞,使用以下環(huán)境變量之一:
$ export HTTP_PROXY="http://proxy.example.com:8888" # also used by npm
$ export HTTPS_PROXY="https://proxy.example.com:8888" # also used by npm
$ export IONIC_HTTP_PROXY="http://proxy.example.com:8888"
其他CLI
npm
$ npm config set proxy http://proxy.company.com:8888
$ npm config set https-proxy https://proxy.company.com:8888
混帳
$ git config --global http.proxy http://proxy.example.com:8888
SSL配置
您可以配置Ionic CLI的SSL(類似于配置npm CLI):
$ ionic config set -g ssl.cafile /path/to/cafile # file path to your CA root certificate
$ ionic config set -g ssl.certfile /path/to/certfile # file path to a client certificate
$ ionic config set -g ssl.keyfile /path/to/keyfile # file path to a client key file
的cafile,certfile和keyfile條目可以手動編輯為字符串?dāng)?shù)組中~/.ionic/config.json包括多個文件诗越。