シンボルファイルのアップロード¶

plugin によるシンボルファイルのパッケージ化¶

ft-plugin のバージョンは 1.3.0 以上が必要です。最新のシンボルファイルパッケージルールに対応し、productFlavor による複数バージョンの区分管理をサポートします。generateSourceMapOnly = true を設定してシンボル圧縮パッケージを先に生成し、その後パブリックネットワークの DataWay 経由でアップロードすることを推奨します。

FTExt {
    // ...
    autoUploadMap = true
    autoUploadNativeDebugSymbol = true
    env = 'common'
    // nativeLibPath='/build/intermediates/merged_native_libs/release/out/lib'
    generateSourceMapOnly = true

    prodFlavors {
        prodTest {
            autoUploadMap = true
            autoUploadNativeDebugSymbol = true
            env = "gray"
            generateSourceMapOnly = true
        }
        prodPublish {
            autoUploadMap = true
            autoUploadNativeDebugSymbol = true
            env = "prod"
            generateSourceMapOnly = true
        }
    }
}

シンボルファイルに関連するパラメータはすべてオプションであり、必要に応じて有効化できます。プロジェクトに複数の productFlavor が含まれる場合は、prodFlavors 内でそれぞれ設定することを推奨します。内部の設定は、外側の同名パラメータを上書きします。

パラメータ名	型	デフォルト値	説明	ユースケース
autoUploadMap	Boolean	`false`	`mapping.txt` を自動でパッケージ化するかどうか。	R8 / Proguard による難読化を有効にしており、Java / Kotlin のスタックトレースを復元する必要がある場合に有効にします。
autoUploadNativeDebugSymbol	Boolean	`false`	Native シンボルファイルを自動でパッケージ化するかどうか。	`ft-native` を導入している、または C/C++ のクラッシュ分析が必要な場合に有効にします。
env	String	空	シンボルファイルが所属する環境。	`prod`、`gray` などのリリース環境を区別する必要がある場合に設定します。
nativeLibPath	String	自動認識	Native so ファイルのディレクトリ。各 ABI ディレクトリの上位パスを指定する必要があります。	デフォルトのパス認識に失敗した場合、または so の出力ディレクトリがカスタマイズされている場合に設定します。
generateSourceMapOnly	Boolean	`false`	シンボル圧縮パッケージのみを生成し、自動アップロードは行いません。圧縮パッケージのパス例：`/app/build/tmp/ft{flavor}SourceMapMerge-release.zip`。`ft-plugin` `1.3.4` 以降でサポートされます。	これを有効にした後、パブリックネットワークの DataWay 経由でアップロードすることを推奨します。
prodFlavors	Closure	空	異なる `productFlavor` に対して、アップロードパラメータを個別に設定します。	マルチチャネル、マルチ環境ビルドにおいて、それぞれ異なるシンボルファイルをアップロードする必要がある場合に使用します。

nativeLibPath は ABI ディレクトリの上位パスまで指定するだけで十分です。例：.../merged_native_libs/release/out/lib。

手動またはスクリプトによるアップロード¶

plugin で generateSourceMapOnly = true を有効にし、gradle task assembleRelease を実行して生成するか、手動で zip ファイルにパッケージ化した後、パブリックネットワークの DataWay 経由で SourceMap をアップロードします。zip コマンドを使用してパッケージ化することを推奨します。これにより、システムの隠しファイルが zip パッケージに含まれるのを防ぐことができます。

詳細については、以下を参照してください。

Unity Native シンボルファイルについては、公式ドキュメントを参照してください。

シンボルファイルのアップロード¶