【Shopify.dev和訳】Themes/Dev tools/Shopify CLI/Troubleshooting

2021/09/30に公開約6,300字

この記事について

この記事は、Themes/Developer tools/Shopify CLI/Troubleshootingの記事を和訳したものです。

記事内で使用する画像は、公式ドキュメント内の画像を引用して使用させていただいております。

Shopify アプリのご紹介

Shopify アプリである、「商品ページ発売予告アプリ | リテリア Coming Soon」は、商品ページを買えない状態のまま、発売日時の予告をすることができるアプリです。Shopify で Coming Soon 機能を実現することができます。

https://apps.shopify.com/shopify-application-314?locale=ja&from=daniel

Shopify アプリである、「らくらく日本語フォント設定|リテリア Font Picker」は、ノーコードで日本語フォントを使用できるアプリです。日本語フォントを導入することでブランドを演出することができます。

https://apps.shopify.com/font-picker-1?locale=ja&from=daniel

Shopify CLI のトラブルシューティング

このリファレンスガイドには、Shopify CLI のアップグレード、レガシーバージョンからの移行、Shopify CLI のアンインストールに関する情報が含まれています。


Shopify CLI のアップグレード

Shopify CLI のアップグレードは、お使いのプラットフォームのパッケージマネージャーで管理できます。Shopify CLI のインストールに使ったものと同じパッケージマネージャーを使ってアップグレードしなければなりません。

拡張機能の開発では、最新の機能をすべて使用するために、特定のノードモジュールを手動でアップデートする必要がある可能性があります。

Homebrew (macOS)

Terminal
brew update
brew upgrade shopify-cli

apt (Debian, Ubuntu)

  1. Shopify CLI の最新の.debファイルをリリースページからダウンロードしてください。
  2. ダウンロードしたファイルをインストールし、/path/to/download/shopify-cli-x.y.z.debをあなたのファイルの場所へのパスに置き換えることを確認してください。
Terminal
sudo apt install /path/to/downloaded/shopify-cli-x.y.z.deb

yum (CentOS 8+, Fedora, Red Hat, SUSE)

  1. Shopify CLI の最新の.rpmファイルをリリースページからダウンロードします。
  2. ダウンロードしたファイルをインストールし、/path/to/downloaded/shopify-cli-x.y.x.rpmをあなたのファイルの場所へのパスに置き換えてください。
Terminal
sudo yum install /path/to/downloaded/shopify-cli-x.y.x.rpm

RubyGems (macOS, Linux, Windows 10)

Terminal
gem update shopify-cli

レガシーバージョンからの移行

バージョン 0.9.0 以降、Shopify CLI は Git リポジトリとしてではなく、ソフトウェアパッケージとしてインストール・管理されています。0.9.0 より前のバージョンを使用している場合は、CLI を使い続けるために 1 回だけの移行を行う必要があります。

以下の手順でレガシーバージョンを削除し、Shopify CLI をパッケージとして再インストールしてください。

  1. レガシーバージョンを使用しているかどうかを確認する
  2. レガシー版の Shopify CLI をアンインストールする
  3. 新しいバージョンをインストールする
  4. CLI を再認証する

レガシーバージョンを使用しているかどうかの確認

レガシーバージョンを使用しているかどうかは、以下のコマンドを実行することで確認できます。command not found というエラーが出た場合は、レガシーバージョンを使用していることになります。

Terminal
shopify version

レガシーの Shopify App CLI をアンインストールする

レガシーバージョンの Shopify CLI をアンインストールするには、以下の手順を実行してください。

  1. レガシー CLI ファイルを削除する
  2. あなたのシェルプロファイルからレガシーの shopify コマンドを削除する
  3. ターミナルをリロードする

レガシー CLI ファイルの削除

デフォルトでは、Shopify CLI はあなたのホームディレクトリにインストールされています。すべてのファイルは.shopify-app-cliという隠しディレクトリに含まれています。以下のコマンドを実行して、そのディレクトリを削除してください:

Terminal
rm -rf ~/.shopify-app-cli/

シェルプロファイルからレガシーの shopify コマンドを削除する

インストールの過程で、Shopify CLI はあなたのシェル構成に一行を追加しました。この行は、あなたのホームディレクトリにある以下のファイルのいずれかにあります。

  • ~/.bash_profile
  • ~/.zshrc
  • ~/.bash_login
  • ~/.profile
  • ~/.config/fish/config.fish

以下の例のように表示されます。正確な表示は、お使いのシステムによって異なります。シェルプロファイルの該当行を削除またはコメントアウトすると、コマンドとしてのshopifyが削除されます。

# The line won’t look *exactly* like this. `HOME_DIR` will instead be the absolute path to your home directory.
if [[ -f /HOME_DIR/.shopify-cli/shopify.sh ]]; then source /HOME_DIR/.shopify-cli/shopify.sh; fi

# The line might not be wrapped in an `if` statement. Example:
[ -f "/HOME_DIR/.shopify-app-cli/shopify.sh" ] && source "/HOME_DIR/.shopify-app-cli/shopify.sh"

ターミナルの再読み込み

シェルプロファイルの変更を有効にするには、ターミナルを終了して、新しいターミナルを起動してください。

  • shopifyを実行しようとすると、command not foundというエラーが出るはずです。
  • shopify_api gem がインストールされている場合は、以下のようなレスポンスが表示されるかもしれません。
shopify command is no longer bundled with shopify_api.
if you need these tools, install the shopify_cli gem

もしそうなら、shopify_api gem を v9.2.0 以上にアップグレードして、その gem に含まれている非推奨のshopifyコマンドを削除する必要があります。

shopify_api gem に依存しているshopify_app gem も持っている場合は、まずshopify_apiをインストールまたはアップデートしてから、古いバージョンをアンインストールする必要があります。

現在インストールされているshopify_apiのバージョンのリストを取得するには、以下のコマンドを実行してください。

Terminal
gem list shopify_api

最新のバージョンをインストールするには、次のコマンドを実行します:

Terminal
gem install shopify_api

古いバージョンをアンインストールするには、次のコマンドを実行します。x.y.zgem listコマンドで表示されたバージョン番号に置き換えてください。必要に応じて繰り返します。

Terminal
gem uninstall shopify_api -v x.y.z

新バージョンのインストール

レガシーバージョンのアンインストールが終わったら、Shopify CLI の最新バージョンをインストールします。お使いのプラットフォームのインストール手順に従ってください。

CLI を再認証する

再認証するには、Shopify CLI で、shopify loginと入力します。


Shopify CLI のアンインストール

Shopify CLI は、インストール時に使用したのと同じパッケージマネージャーを使って、システムから削除することができます。

Homebrew (macOS)

Terminal
brew uninstall shopify-cli

apt (Debian, Ubuntu)

Terminal
sudo apt remove shopify-cli

yum (CentOS 8+, Fedora, Red Hat, SUSE)

Terminal
sudo yum remove shopify-cli

RubyGems (macOS, Linux, Windows 10)

Terminal
gem uninstall shopify-cli

レガシーバージョンをアンインストールする

Shopify CLI のレガシーバージョン(0.9.0以下)を使用している場合は、手動でアンインストールする必要があります。


次のステップ


Shopify アプリのご紹介

Shopify アプリである、「商品ページ発売予告アプリ | リテリア Coming Soon」は、商品ページを買えない状態のまま、発売日時の予告をすることができるアプリです。Shopify で Coming Soon 機能を実現することができます。

https://apps.shopify.com/shopify-application-314?locale=ja&from=daniel

Shopify アプリである、「らくらく日本語フォント設定|リテリア Font Picker」は、ノーコードで日本語フォントを使用できるアプリです。日本語フォントを導入することでブランドを演出することができます。

https://apps.shopify.com/font-picker-1?locale=ja&from=daniel

Discussion

ログインするとコメントできます