Membuat Versi Release Idris Back Media

Terakhir dicek: 15 September 2026.

Versi release adalah Idris Back Media yang sudah dibangun dan bisa dijalankan tanpa source code dan tanpa .NET SDK. Panduan ini menjelaskan cara membuatnya, isi hasilnya, dan satu jebakan yang membuat release terlihat berhasil padahal langsung crash saat dibuka.

Jangan membuat release sebagai satu file exe (PublishSingleFile=true). Proses publish-nya selesai tanpa error, tapi exe yang dihasilkan crash saat dibuka. Buktinya ada di bagian akhir panduan ini.

Perintah yang benar

Tutup dulu versi release yang sedang terbuka, lalu jalankan dari folder proyek:

dotnet publish "Idris Back Media.csproj" -c Release -r win-x64 -p:SelfContained=false -p:PublishSingleFile=false -o bin\Release\publish-folder

"Idris Back Media.csproj": tunjuk file proyeknya langsung. Kalau tidak, dotnet memakai file solution, dan opsi -o memunculkan peringatan NETSDK1194.
-p:SelfContained=false: runtime .NET tidak ikut dimasukkan, jadi komputer tujuan harus sudah memasangnya (lihat di bawah).
-p:PublishSingleFile=false: hasilnya berupa satu folder, bukan satu exe. Ini bagian yang penting.
-o bin\Release\publish-folder: folder tujuan hasilnya.

Di komputerku, publish pertama butuh 69 detik, 31 detik di antaranya untuk mengunduh ulang paket. Publish berikutnya hanya 2 sampai 5 detik, karena hasil kompilasinya dipakai ulang. Perintah di atas selesai dengan kode keluar 0 dan tanpa peringatan.

Isi folder hasilnya

Isi	Ukuran	Keterangan
`Idris Back Media.exe`	0,17 MB	Hanya peluncur. Kodenya ada di file `.dll` di sebelahnya.
`libvlc\`	279,3 MB	Pemutar video untuk preview (VLC), 956 plugin
`Resources\`	9,5 MB	Aset aplikasi
`runtimes\`	3,7 MB	Library native, termasuk Whisper untuk Auto-Subtitle
Total	405 MB	1340 file

Exe-nya tidak bisa dipindah sendirian. Kalau mau memindahkan atau membagikan versi release, salin seluruh isi folder, misalnya dengan menjadikannya satu file zip.

File yang harus disalin manual

Dua file workflow ComfyUI tidak ikut ke folder hasil publish, karena letaknya di akar folder proyek dan tidak terdaftar sebagai file yang ikut disalin saat build:

comfy_api.json: dipakai AI Image Generator, Foto to Video, dan gambar di AI Storyboard.
comfy_api_instantid.json: dipakai saat generate gambar dengan wajah acuan.

Salin keduanya dari folder proyek ke dalam folder release, di sebelah Idris Back Media.exe. Kalau lupa, fitur ComfyUI akan gagal dengan pesan:

File comfy_api.json tidak ditemukan!

Menjalankan di komputer lain

Komputer tujuan butuh:

Windows 64-bit.
.NET 10 Desktop Runtime. Cukup runtime, bukan SDK. File Idris Back Media.runtimeconfig.json di folder release meminta Microsoft.NETCore.App dan Microsoft.WindowsDesktop.App versi 10.0.
ffmpeg untuk export (lihat panduan P1).
Server lokal sesuai fitur yang dipakai (lihat panduan P2).
Pengaturan API diisi ulang (lihat panduan P3).

Di komputer yang sama, versi release dan versi dari source berbagi pengaturan yang sama. Kunci API ada di %APPDATA%\Idris Back Media\ dan model Whisper di %LOCALAPPDATA%\IdrisBackMedia\models, jadi tidak perlu diisi atau diunduh ulang.

Versi release tetap menjalankan test sebelum jendelanya terbuka, sama seperti versi dari source. Test 4 subtitle mencari file contoh Tests/Fixtures/speech_test.wav relatif terhadap folder tempat exe dijalankan. Kalau file itu tidak ada, misalnya saat exe dibuka dengan klik dua kali, test itu dilewati dengan pesan [SKIP] dan aplikasi tetap terbuka.

Menguji hasil release

Jangan anggap release beres hanya karena publish-nya tidak error. Uji dengan menjalankan exe-nya dari folder proyek, supaya Test 4 ikut berjalan dan benar-benar memakai Whisper:

& ".\bin\Release\publish-folder\Idris Back Media.exe"

Setelah jendelanya terbuka, impor satu video, taruh di timeline, lalu tekan play untuk memastikan preview-nya tampil.

Hasil ujiku dengan cara di atas: semua test lolos, termasuk Test 4 yang mentranskripsi file suara dalam 14,3 detik. Jendela aplikasi terbuka, dan video di preview bisa diputar.

[Test 4] Transkripsi selesai dalam 14,3s ...
=== ALL V3.2C INVARIANT TESTS PASSED CLEANLY (4/4) ===
=== ALL VOLUME ENVELOPE & AUTO-DUCK TESTS PASSED ===
=== ALL TTS SYNC TESTS PASSED ===

Saat video diputar, konsol bisa menampilkan pesan dari VLC seperti avcodec decoder error: hardware acceleration picture allocation failed. Di komputerku pesan itu muncul, tapi preview tetap tampil normal.

Kenapa bukan satu file exe

Perintah release yang lama memakai -p:PublishSingleFile=true supaya hasilnya satu file exe. Publish-nya selesai dengan kode keluar 0, tapi ada satu peringatan yang gampang terlewat:

warning NETSDK1236: The single-file bundle generation task excluded files that were expected to be included: ...libvlc.dll, ...libvlccore.dll, ...plugins\...

Ada 975 file native yang dikecualikan: libvlc.dll beserta 956 plugin VLC, dan 12 file Whisper. File-file itu tidak masuk ke dalam exe dan juga tidak tersalin ke folder hasilnya, sehingga hasilnya hanya 311 file (129 MB).

Exe tunggal itu dijalankan dari folder proyek, dan langsung mati di Test 4 sebelum jendelanya muncul:

[Test 4] Transkripsi ASR fixture 'Tests/Fixtures/speech_test.wav'...
Unhandled exception. System.IO.FileNotFoundException: Native Library not found in default paths.
Verify you have have included the native Whisper library in your application, or install the
default libraries with the Whisper.net.Runtime NuGet.

	Satu file exe	Satu folder
Hasil publish	311 file, 129 MB	1340 file, 405 MB
VLC (preview)	hilang	lengkap, 956 plugin
Whisper (Auto-Subtitle)	hilang	lengkap
Saat dijalankan	crash di Test 4	semua test lolos, preview jalan

Pelajarannya: kode keluar 0 bukan bukti release-nya jalan. Selalu baca peringatannya, lalu jalankan hasilnya sampai jendelanya terbuka dan fiturnya dicoba.

Ringkasan

Perintah : dotnet publish "Idris Back Media.csproj" -c Release -r win-x64
           -p:SelfContained=false -p:PublishSingleFile=false -o bin\Release\publish-folder
Hasil    : satu folder, 1340 file, 405 MB (bukan satu exe)
Salin    : comfy_api.json dan comfy_api_instantid.json ke folder release
Butuh    : Windows 64-bit + .NET 10 Desktop Runtime
Uji      : jalankan exe dari folder proyek, lalu coba putar video
Hindari  : PublishSingleFile=true (crash: Whisper dan VLC hilang)