KINTONE

kintoneプラグイン開発で最速でつまづいた話（"npm run develop" was failed）

こんにちは、今日は kintoneプラグイン開発 に初挑戦して、秒でつまずいた話を共有します。未来の自分と同じようにハマりそうな人のために、ログを残しておきます。

参考にした記事: kintone プラグインを最速で作る手順（自己メモ）

💻 開発環境

  • OS: Windows 11
  • Node.js: v20.17.0

🛠 プロジェクト作成

npx @kintone/create-plugin empty-plugin

質問に答えながら進めていく感じ、（省略可）となっているところはすべて省略しました。（重要）

📦 初期コマンドの実行

cd empty-pluginnpm start

そして表示されたメッセージ…

> empty-plugin@0.1.0 start
> node scripts/npm-start.js

> empty-plugin@0.1.0 develop
> npm run build -- --watch

> empty-plugin@0.1.0 upload
> kintone-plugin-uploader dist/plugin.zip --watch --waiting-dialog-ms 3000

> empty-plugin@0.1.0 build
> kintone-plugin-packer --ppk private.ppk --out dist/plugin.zip src --watch

"npm run develop" was failed

(え、最初のnpm startでつまずくとかある？)

🔍 原因調査フェーズ突入

  • scripts/npm-start.js 見る
  • package.json 見る
  • フォルダ構成チェック

…と、いろいろ見たけど結局わからず。(nodeに詳しかったらすぐわかるのかも)

🧪 コマンド直接叩いてみた

npm run build -- --watch

すると、こんなエラーが出力：

WARN: Property "homepage_url.en" is missing.Invalid manifest.json:- "/name/ja" must NOT have fewer than 1 characters- "/description/ja" must NOT have fewer than 1 charactersFailed: Invalid manifest.json

(え、”省略可”って言ったよね？)

✅ 解決法

ということで、

  • empty-plugin フォルダを削除
  • 再度 npx @kintone/create-plugin で作り直し
  • 「日本語名」と「日本語の説明」を空欄にせず入力

これだけで動いた！

💡 まとめ：kintoneプラグイン開発でつまずかないために

  • manifest.jsonのname/jaとdescription/jaは空欄にしない！
    → たとえ (省略可) と書いてあっても、省略しない方が無難
  • エラーが出たら npm run build -- --watch を直接叩いて原因調査

偏見だが国内メーカーのはこういうエラー隠しとかするのが厄介…

この記事が、未来のあなたの時間節約につながれば幸いです 🙌

BACK TO LIST