メインコンテンツへスキップ
Fabled

モジュール作成者

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

検証、アーカイブ、認証、ネットワーク、レビューの失敗を安全な次のステップにマッピングします。

検証が失敗しました

  • モジュール validate を実行します。 --json を指定し、エラー コードと JSON ポインターを使用してマニフェストまたはアセット フィールドを見つけます。
  • マニフェストが見つからない場合は、名前を fabled.module.json に変更します。従来の fabled-module.json が両方とも存在する場合は削除します。
  • 編集後に、すべてのアセットの宣言されたバイトと sha256 を更新します。モジュール パックはこれらの宣言を検証し、最終的なアーカイブ ダイジェストを計算します。ソース宣言は書き換えられません。
  • パッケージ/パブリッシャー ID の構文、正確なセマンティック バージョン、サポートされているターゲット/スロットの組み合わせ、機能の同意、ロケール タグ、コントリビューション参照、および連続移行を確認してください。

アーカイブ検査が失敗します

モジュール パックを使用してアーティファクトを再作成します。汎用 ZIP ツールは、圧縮、コメント、プラットフォーム メタデータ、リンク、重複/大文字と小文字の衝突のある名前、または安全なプロファイルが拒否するデータ記述子を追加する場合があります。アーカイブは 5 MiB 未満、各エントリは 1 MiB 未満、エントリ数は 128 以下に保ちます。

ログインまたは保存された資格情報が失敗する

  • [アカウント] → [セキュリティ] で新しいコードを生成します。コードは 120 秒後に期限切れになり、一度だけ機能します。
  • 正確な fabled://module-cli URI または 43 文字のコードのみを貼り付けます。引数として渡さないでください。
  • セッションが期限切れ、拒否済み、または旧バージョン1の形式の場合は、CLI からログアウトして再度ログインしてください。サーバーでの無効化に失敗した場合は、有効な認証情報ファイルを削除する前に再試行してください。旧ファイルを削除しても、その Firebase セッションは無効化されません。
  • POSIX では、親ディレクトリをプライベート所有権/権限に修正し、資格情報ファイルを 0600 に修正します。 Windows では、ACL で保護されたプライベート ユーザー プロファイル パスを使用します。
  • ローカル開発では、FABLED_API_URL を対応するループバックのバックエンドに設定し、ローカル Fabled のアカウントページでコードを生成してください。CLI に Firebase Web キーは不要です。ペアリング時に選んだ API オリジンを継続して使用してください。

公開またはレビューが失敗する

  • 401/403: 再度ログインするか、指定された自動トークンに発行者/送信アクセス権があることを確認します。
  • 409: 不確実な応答の後に新しいリクエスト ID を作成しないでください。出力された --request-id を使用して同じアーティファクトを再試行します。真に不変の競合には、新しいバージョンまたは修正された名前空間が必要です。
  • 413: 宣言されたアセットを減らし、5 MiB の許可制限未満に再パックします。
  • CHANGES_REQUESTED: reviewerNote、automaticFindings、およびモジュール ステータス --json の警告を読み、プロジェクトを変更し、不変のリリース バージョンをインクリメントし、検証し、パックして、再度送信します。
  • ベータ サービス ゲートがオフになっている間は、有効な CLI コマンドが使用できない場合があります。この問題は、マニフェストや認証情報を弱めても修正されません。

モジュールは取得されましたが、実行されていません

  • 取得により付与されるのは権利のみです。アカウント ライブラリを開き、[インストール] を選択し、提示されたリリース条項を正確に受け入れて、対象となるアカウント対象モジュールの [アクティブ化] を選択します。
  • インストールが利用できない場合は、パッケージとリリースがアクティブでレビューされていること、資格がアクティブであること、インストール ロールアウト ゲートが有効であることを確認してください。
  • アクティベートが利用できない場合は、承認されたリリース、ホストの互換性、依存関係、ランタイム ポリシー、署名、およびアクティベーション ロールアウト ゲートを確認してください。
  • コミュニティモジュールをキャンペーンで有効にするには、対応するバックエンドがデプロイされ、インストール済みの正確なリリースの条件に同意し、有効な ADMIN_GRANT または FREE_ACQUISITION の権限があることを確認してください。有効化や無効化を行えるのはキャンペーンの所有者本人だけです。