legacy-knowledge-base
公開されました Jul. 2, 2025

gulp upgrade コマンドを実行すると、「バージョン固有のアップグレード タスクは機能を返す必要があります」というエラーが表示されます

投稿者

Alfonso Crisci

knowledge-article-header-disclaimer-how-to

knowledge-article-header-disclaimer

legacy-article

learn-legacy-article-disclaimer-text

問題

  • テーマ ジェネレーターで作成されたテーマをアップグレードし、テーマ自体をアップグレードする手順 (gulp upgrade) を実行すると、次のエラー メッセージが返されます。
    [18:20:11] Starting 'upgrade'...
    [18:20:11] 'upgrade' errored after 680 μs
    [18:20:11] Error in plugin "gulp-theme-upgrader"
    Message:
    Version specific upgrade task must return function.

Environment

  • Liferay DXP 7.0+

解決策

  • コマンドの引数として、最終的な宛先バージョンを指定します。 たとえば、7.2 DXP の場合:
    gulp upgrade -v 7.2

追加情報

did-this-article-resolve-your-issue

legacy-knowledge-base