A one day, single-track online event celebrating the future of cross-platform app development

iOS トラブルシューティングガイド

100％完璧な Native 管理ツールを作成するのはほぼ不可能です。遅かれ早かれ iOS ワークフローの一部でさまざまな問題に遭遇するでしょう。

このガイドでは、考えられる解決策とともに一般的な iOS / Xcode の問題を文書化することを試みます。

iOS Toolbox

iOS 開発者は誰でも、iOS の問題をデバッグするためのいくつかの一般的なテクニックを学んでおり、これらを自分のワークフローに組み込む必要があります。

iOS や Xcode で何か問題が発生した場合、最初のステップは Google 検索にエラーをコピペすることです。

Capacitor は標準的な iOS ツールチェーンを使用していますので、あなたが何かに遭遇した場合、多くの iOS 開発者も同様に遭遇している可能性があり、そこには解決策があるはずです。

依存関係の更新、クリーン実行、派生データの削除などの簡単な方法があります。

Clean と Rebuild を行うことで、多くのビルドの問題を解決することができます。Xcode メニューの Product -> Clean Build Folder を選択して、現在のビルドをクリーンアップします。

Xcode は古い、時代遅れのビルドアーティファクトに固執することがあります。新たに始めるには、ディスク上の派生データを削除する必要があります。

これを行うには、Xcode の環境設定を開き、Locations タブを選択して、Derived Data パスの横にある小さな矢印をクリックします:

これにより、Xcode の一時的な Derived Data の場所に Finder ウィンドウが開きます。

次に、そのディレクトリ内のすべてのアイテムを選択し、削除します:

最後に、Xcode でリビルドを行います。

このエラーは、CocoaPods が依存関係をインストールするために実行できなかった場合に起こります。

これを実行して Pod を更新してください。

npx cap update ios

このコマンドを実行した後、新規にビルドを行います。

Xcode は時々、永遠にインデックス作成に行き詰まることがあります。この不幸な状況は次のようなものです:

唯一の解決策は、アクティビティモニタを使って Xcode を強制終了し、再度起動させることです。

このエラーは、古いバージョンの openssl と ruby がインストールされた Mac で発生する可能性があります。これは、GitHub がリポジトリへのアクセス時に使用できる暗号プロトコルを制限しているためです。

解決策は、openssl をアップデートし、Ruby をアップデートすることです:

brew install openssl
brew upgrade openssl
brew install ruby
brew link --overwrite ruby

最後に、環境変数 PATH が $PATH の後に /usr/local/bin を置くのではなく、その前に置くようにしてください。

この問題に対する他の可能な解決策については、この StackOverflow の問題を参照してください。