VoltMX Irisでプロジェクトが開かない時に試したい8つの対処法

## 目次
1. はじめに
2. 対処法
3. 最後に


## はじめに

Irisでプロジェクトを開く際に、
Loading...のポップアップが表示されたり、エラーが出てプロジェクトが開かない場合があります。

<img src="https://qiita-image-store.s3.ap-northeast-1.amazonaws.com/0/592264/72a8e74f-7cc9-f52c-b4bf-7cbbc68b50a6.png" width="500">

プロジェクトが開かない時に、いくつか対処法があるので、
その方法についてご紹介していきます！

その他のよく遭遇するエラーについては、以下も併せてご確認ください。

- [Konyでよく遭遇するエラーまとめ ＊Kony Visualizer 起動〜開発編＊](https://qiita.com/Kony_Team/items/0667ca2c8ee346f046d7)
- [Konyでよく遭遇するエラーまとめ ＊Build編（共通）＊](https://qiita.com/Kony_Team/items/4a1ac93faf43b2a92dc3)
- [Konyでよく遭遇するエラーまとめ ＊Build編（iOS）＊](https://qiita.com/Kony_Team/items/2dbb66b34c05e09369f7)


## 対処法
まず対処法を見ていく前に以下のポイントをチェックしてみましょう👀
どれかが抜けている場合は、解消方法のリンク先をチェックしてみましょう。

|チェックポイント|解消方法|
|--|--|
|プロジェクト名にハイフンやアンダーバーが含まれていないか|[こちら](#ハイフンやアンダーバーを削除してプロジェクトのクローンを行う)|
|modules配下にreadmeファイルが入っていないか|[こちら](#modules配下のreadmeファイルを削除する)|
|userwidgets配下にjsonファイルのないコンポーネントファイルがないか|[こちら](#userwidget内の空のフォルダを削除する)|
|Irisとプロジェクトのバージョンが一致しているか|[こちら](#irisのバージョンをプロジェクトのバージョンに合わせる)|

上記のチェックポイントも問題ない場合、[強制終了→PC再起動→アプリ再起動](#強制終了pc再起動アプリ再起動)以降の方法を試してみてください。

### ハイフンやアンダーバーを削除してプロジェクトのクローンを行う

ハイフンやアンダーバーが含まれているプロジェクトの場合、
プロジェクトがうまく開けない場合があります。
（例：project_name , project-name 等）

GitからSource Treeでプロジェクトをクローンする際に、
該当の文字を削除することで解消することがあります。

下記の記事に手順が詳しく記載されているので、参考にしてみてください:point_down_tone2:
[Konyでよく遭遇するエラーまとめ ＊Kony Visualizer 起動〜開発編＊](https://qiita.com/Kony_Team/items/0667ca2c8ee346f046d7)

### modules配下のreadmeファイルを削除する

プロジェクトフォルダのmodules配下に`readme.md`ファイルがある場合  
Loadingから動かずプロジェクトが開けないことがあります。  

この場合、`readme.md`ファイルを削除することで正常に開くようになります。
modules配下にいくつかフォルダがある場合、全てのフォルダ内をチェックしてみてくださいね🙆‍♂️

`/Users/ユーザ名/ワークスペース名/プロジェクト名/modules`

![スクリーンショット_0005-10-25_15_32_48.png](https://qiita-image-store.s3.ap-northeast-1.amazonaws.com/0/592264/825a2c74-dcdb-2670-fddb-a7715b92255a.png)


### UserWidget内の空のフォルダを削除する

プロジェクトを開こうとすると、以下のエラーが出てプロジェクトが開けない場合があります。

`Open Project Failed! Cannot build graph dependencies: "TypeError. Cannot read properties of undefined (reading 'length')"`

<img src="https://qiita-image-store.s3.ap-northeast-1.amazonaws.com/0/592264/c3daa818-55b1-9fbe-291e-3889f015b59b.png" width="500">


この場合、ブランチの切り替え等が原因でコンポーネントに不要なデータが入っていることが原因のエラーとなります。   

UserWidgets配下に、jsonファイルが存在しないコンポーネントのフォルダがないか確認をしましょう。
もし以下のような状態のコンポーネントファイルがある場合、
そのコンポーネントファイル自体を削除してください。  
例：`/Users/ユーザ名/ワークスペース名/プロジェクト名/userwidgets/コンポーネント名`
削除後、もう一度プロジェクトを開くとうまく開けるようになります！


不具合が起きる場合のフォルダの状態
![スクリーンショット_0005-10-25_16_04_41.png](https://qiita-image-store.s3.ap-northeast-1.amazonaws.com/0/592264/b11f17ad-389c-5a64-f704-acf537aa0b78.png)

正常にプロジェクトが開ける場合のフォルダ構成は以下のようになっています。
![スクリーンショット_0005-10-25_15_26_46.png](https://qiita-image-store.s3.ap-northeast-1.amazonaws.com/0/592264/90ecabf5-6e3e-a458-2aea-d8346cc71799.png)

### Irisのバージョンをプロジェクトのバージョンに合わせる

もしプロジェクトのIrisのバージョンが、
自分が使っているIrisのバージョンよりも低い場合、
バージョンに合わせて書き換えを行う際に、書き換えに失敗しプロジェクトを開けなくなっている可能性があります。

その場合は、プロジェクトのIrisバージョンに合わせることで
プロジェクトが開けるようになります。

プロジェクトのIrisバージョンを確認するには、
`projectProperties.json`ファイルの`konyVizVersion`の値で確認することができます。


![image.png](https://qiita-image-store.s3.ap-northeast-1.amazonaws.com/0/592264/be5de080-9140-3bd6-f80c-fa3c8faa9faf.png)


上記の場合は、 Iris version 9.5.8で作成されているので、
Irisのバージョンは9.5.8をダウンロードすると良いです🙆‍♂️


:::note warn
もしプロジェクトで指定されているバージョン以上を使っている場合は（今回の場合ver9.5など）、
Service Packバージョンが同じでないとダウングレードはできないため、
再度ダウンロードを行うようにしてください。

ダウングレードに関する記事は、以下に詳しく書いてあります。
👉  [Konyのバージョンをダウングレード・アップグレードする方法](https://qiita.com/Kony_Team/items/9623c054c3f3b122621f#version9%E3%81%AE%E5%A0%B4%E5%90%88)

:::

ダウンロードサイトで別バージョンをダウンロードする方法は、こちらを参考にしてください。
👉 [Kony Visualizerの環境設定](https://qiita.com/Kony_Team/items/cb012a9b3eeb5832ac9d#1-visualizer%E3%83%80%E3%82%A6%E3%83%B3%E3%83%AD%E3%83%BC%E3%83%89)

＜補足＞
もし、**現在使っているIrisのバージョンを残したまま別バージョンを使いたい場合**、
ダウンロードサイトでダウンロード後、インストーラーが起動したら、
アプリケーションフォルダ直下に新規フォルダを作成しておきましょう。

インストール先を指定する画面で、「Choose..」ボタンを押して、
作成しておいたフォルダをインストール先に指定すると、
複数のIrisを共存させることができます！


![image.png](https://qiita-image-store.s3.ap-northeast-1.amazonaws.com/0/592264/ead8b6d4-da72-b25d-e5e8-391007d33761.png)

Irisが起動したら、いつもと同じようにプロジェクトをクローンし、
開くとプロジェクトが開くようになるかと思います👍


### 強制終了→PC再起動→アプリ再起動
上記の方法でもうまくいかない場合、
一度Irisを強制終了→PC再起動→Irisを再起動してみましょう。

### プロジェクト配下のフォルダを全削除後リフレッシュ
プロジェクトの中に不要なファイルが含まれている場合等プロジェクトが開けないことがあります。
プロジェクト配下のフォルダを全削除し、Irisを更新することで解消することがあります。

①プロジェクト配下のファイルを全て削除します
![スクリーンショット_0005-10-25_15_44_56.png](https://qiita-image-store.s3.ap-northeast-1.amazonaws.com/0/592264/b0209c4c-10b2-6c1a-c527-da551681b438.png)

②プロジェクト管理ツール（今回はsourcetree）を開き、差分をリセット
プロジェクト管理ツールを開くと、削除した分の差分が表示されるため全て選択しリセットを行います。
![スクリーンショット_0005-10-25_15_51_05.png](https://qiita-image-store.s3.ap-northeast-1.amazonaws.com/0/592264/7c35c061-dc87-2acb-9c48-79c7e7c88c89.png)

③IrisでRefresh
差分を全てリセットできたら、Irisを開きProject->Refreshを押して更新しましょう。
![スクリーンショット_0005-10-25_15_52_39.png](https://qiita-image-store.s3.ap-northeast-1.amazonaws.com/0/592264/6576d38e-8fc2-5050-7249-0f508336116d.png)


### 別のワークスペースを作成
別のワークスペースを作成し、該当のプロジェクトを再度入れ直すことで解決することがあります。

①任意の場所にワークスペースを作成します。
例：`/Users/ユーザー名/任意のフォルダ/ワークスペース名`

![スクリーンショット_0005-10-25_15_57_39.png](https://qiita-image-store.s3.ap-northeast-1.amazonaws.com/0/592264/91e449f8-4274-debb-f965-5e15db00c5b1.png)


②新しいワークスペースを作成できたら、その中にプロジェクトをクローンします。
（※この時必ず「保存先のパス」でプロジェクト名に、ハイフンやアンダーバーが入らないようにしてください。）


![image.png](https://qiita-image-store.s3.ap-northeast-1.amazonaws.com/0/592264/e23deb8e-f2bf-e1b3-2cf6-8ae2236cf923.png)

③クローンが完了したら、Irisを開き新しいワークスペースに移動します。

IrisのProject->Switch Workspaceをクリック。
![スクリーンショット 0004-05-24 10.16.50.png](https://qiita-image-store.s3.ap-northeast-1.amazonaws.com/0/592264/c2849ce1-d880-33a4-b3dc-78fbbd53fcec.png)

ポップアップが表示されたら、Browseボタンを押して、  
新しく作ったワークスペースを選択してください。


![image.png](https://qiita-image-store.s3.ap-northeast-1.amazonaws.com/0/592264/18f14270-4723-3bf9-b57d-a19961e9054c.png)

新しいワークスペースを指定できたら、OKボタンを押します。

④ワークスペースが開いたら、いつもプロジェクトを開く時と同じように、
Project -> Open をクリックし、クローンしてきたプロジェクトを選択します。
![スクリーンショット 0004-05-24 10.26.41.png](https://qiita-image-store.s3.ap-northeast-1.amazonaws.com/0/592264/2c0aef9e-d0ce-1019-053f-1ab9e1f798b6.png)



### ログを見てエラーの原因を確認する

上記で紹介した方法でも、プロジェクトが開かなかったり、
プロジェクトが開いてもビルドが失敗してしまう・・という場合、
**Irisのログを見ることで原因を知ることができます。**



Irisのlogファイルを確認するためには下記フォルダを開きます。
`/Users/ユーザ名/iris/irisdata/logs`

![image.png](https://qiita-image-store.s3.ap-northeast-1.amazonaws.com/0/592264/71141d00-b612-4ee7-0c35-44e2e55c0106.png)

フォルダを開いたら「**iris.log**」というファイルを開くことで、
logファイルの確認ができます。


![image.png](https://qiita-image-store.s3.ap-northeast-1.amazonaws.com/0/592264/465eb544-3d5b-4d47-bee7-9b25778844ef.png)


logファイルを開いたら、**Buildが完了した時間付近のログを確認します。**
その後そのログ内で**error**などの文字がある箇所を探すことで、
Buildが失敗した原因を特定することができます。

![image (1).png](https://qiita-image-store.s3.ap-northeast-1.amazonaws.com/0/592264/0ba6b52b-41a4-0a28-fd8d-775f9299d922.png)
 （上記画像の場合はResourceに画像がなかったため、Buildが失敗していました。）

ログを見れるようになると、
エラーの原因がわかったり不要なフォルダが入っていないか確認するのに役立ちます！
是非参考にしてみてくださいね。


## 最後に
プロジェクトが開けない場合の対処法について紹介しました！

よくはまるポイントなので、同じように困っている人がいたら
この方法を紹介してみてくださいね:relaxed::wave_tone1: