CompInstall

Penginstal Komponen

Utilitas aplikasi Delphi untuk menginstal paket komponen secara otomatis ke IDE.

• Apa yang baru
• Keterangan
• Fitur
• Cara menggunakan
• Struktur Compinstall.ini

Apa yang baru

• 02/20/2024 (Versi 2.6)

  • Dukungan Delphi 12.
  • Properti INI baru: Iniversion, OutputPath, dan Paket Path
  • PublishFiles sekarang mendukung sub-folder.
  • Hapus semua file dan sub-folder saat memperbarui dari GitHub.
  • Mendeteksi kompiler yang tidak didukung.

Klik di sini untuk melihat seluruh changelog

• 09/12/2021 (Versi 2.5)

  • Dukungan Delphi 11.

• 03/25/2021 (Versi 2.4)

  • Karena ini bukan praktik yang baik untuk menyematkan EXE installer komponen dalam sumber komponen GitHub, pembaruan repositori GitHub telah dimodifikasi untuk tidak memperbarui EXE installer komponen, tetapi hanya sumber komponen yang dikonfigurasi.
  • Fungsi cadangan yang dihapus dalam pembaruan otomatis GitHub.

• 02/01/2021 (Versi 2.3)

  • Memperbaiki pembuatan sub-folder (hilang) saat mengekstraksi file pada pembaruan github.
  • Folder cadangan baru pada pembaruan github (folder aktual akan diganti namanya menggunakan tanggal dan waktu sufix).

• 12/18/2020 (Versi 2.2)

  • Memperbaiki panggilan ke rsvars.bat ketika Delphi dipasang di jalur yang berisi karakter spasi.

• 10/31/2020 (Versi 2.1)

  • Termasuk Delphi 10.4 Sydney Support.
  • Verifikasi yang diimplementasikan dari keberadaan kompiler Delphi 64-bit ketika bendera 64-bit ditetapkan.

• 10/26/2020 (Versi 2.0)

  • Proses kompilasi sekarang menggunakan utas.
  • GitHub memperbarui pendukung otomatis.

• 05/03/2020 (Versi 1.2)

  • Memperbaiki metode registerbpl karena delphi xe5 atau di bawah menggunakan folder publik "Rad Studio" sebagai gantinya "Embarcadero Studio".

• 02/15/2019 (Versi 1.1)

  • Parameter ALLIVE64BIT yang dihapus di bagian Umum. Aplikasi akan mendeteksi parameter ini secara otomatis ketika muncul pada parameter paket apa pun.

Keterangan

Aplikasi ini memungkinkan Anda untuk mendistribusikan komponen Delphi Anda tanpa harus melakukan daftar tugas panjang untuk secara manual menginstal komponen ke IDE ( ketika Anda menyediakan sumber komponen, tentu saja ).

Selain itu, jika komponen di -host di GitHub, Anda dapat menunjukkan jalur repositori dan aplikasi akan memeriksa pembaruan secara langsung dalam rilis repositori.

Fitur

• Mendeteksi semua versi Delphi yang diinstal dan memungkinkan programmer untuk memilih IDE mana yang akan dipasang.
• Kompilasi paket menghasilkan file BPL.
• Menginstal paket ke IDE.
• Mendaftarkan jalur ke jalur perpustakaan.
• Salinan file sumber daya yang diperlukan untuk dikompilasi folder (.dfm, .res, ...).
• Komponen memperbarui yang dihosting di GitHub secara otomatis.
• Mendukung kompilasi 32 bit dan 64 bit.

Cara menggunakan

Anda hanya perlu membuat file INI yang disebut compinstall.ini dan menulis parameter ke aplikasi.

Kemudian masukkan compinstall.exe dan compinstall.ini ke dalam direktori paket komponen Anda dan berbahagialah.

Catatan: Aplikasi ini membutuhkan MSBuild, yang ada di .NET Framework 2.0, 3.5 dan 4.0. Ketika aplikasi diluncurkan, itu akan memverifikasi jika ada MSBuild tersedia.

Struktur Compinstall.ini

Bagian [Template]

IniVersion (wajib) = Versi struktur INI ( Versi Saat Ini = 2 )

Jika versi INI lebih tinggi dari versi yang didukung aplikasi saat ini, aplikasi akan menampilkan pesan kesalahan dan memblokir instalasi.

[General] Bagian

Name (wajib) = Nama Komponen Ditampilkan di Formulir Instal dan Terdaftar ke Paket Delphi.

Version (diperlukan) = Versi Komponen Ditampilkan pada formulir Instal dan digunakan oleh Kontrol Pembaruan Otomatis GitHub (jika diaktifkan).

DelphiVersions (wajib) = Daftar yang dipisahkan oleh ";" dengan semua versi Delphi didukung oleh komponen. Menurut versi Delphi yang diinstal di Windows dan menggabungkan dengan parameter ini, combobox dalam formulir instal akan mencantumkan semua versi Delphi yang mungkin.

Nilai yang Didukung: 2005; 2006; 2007; 2009; 2010; Xe; Xe2; Xe3; Xe4; Xe5; Xe6; Xe7; Xe8; 10; 10.1; 10.2; 10.3; 10.4; 11; 12

Packages (diperlukan) = Ini adalah daftar yang dipisahkan oleh ";" dengan paket yang akan dikompilasi, dalam urutan yang benar. Cukup ketikkan nama paket tanpa ekstensi file.

AddLibrary (opsional) = 0 atau 1. Ketika 1, jalur folder rilis komponen akan didaftarkan ke jalur perpustakaan Delphi.

OutputPath (Opsional) = Folder Relatif di mana file yang dikompilasi disimpan (harus dikonfigurasi sama dalam pengaturan paket). Anda dapat menggunakan {PLATFORM} dan {CONFIG} variabel. Nilai default adalah: {PLATFORM}{CONFIG} (sekarang, {config} selalu "rilis").

Bagian Paket

Untuk menentukan parameter paket, buat bagian dengan nama paket dengan awalan P_ , seperti:

[P_MyPackage]

Path (opsional) = folder relatif di mana file paket berada. Jika kosong, paket harus di folder root komponen.

Allow64bit (opsional) = 0 atau 1. Ketika 1, tentukan paket ini untuk dikompilasi dua kali, dengan versi 32-bit dan 64-bit. Ingatlah untuk membuat platform ini di Delphi Project Manager, jika tidak, kompilasi 64-bit akan gagal.

Jika ada paket yang memiliki opsi ini diaktifkan, itu akan ditampilkan kotak centang yang memungkinkan menginstal komponen versi 64-bit (kotak centang mulai diperiksa secara default).

PublishFiles (opsional) = Ini daftar yang dipisahkan oleh ";" Dengan semua file yang ingin Anda salin ke folder rilis (biasanya file formulir DFM yang digunakan saat runtime dan file sumber daya).

Install (opsional) = 0 atau 1. Ketika 1, paket ini akan diinstal ke Delphi IDE. Anda perlu mengatur opsi ini untuk paket waktu desain saat Anda ingin mendaftarkan komponen ke Delphi IDE.

Catatan: Aplikasi mengkompilasi komponen Anda menggunakan Target Rilis Selalu.

Bagian [GitHub]

Repository (Opsional) = Memungkinkan Anda untuk menentukan repositori GitHub (Sintaks: GitHub account / Repository name ), jadi ketika aplikasi dimulai, ia akan memeriksa pembaruan komponen menggunakan API GitHub, membaca rilis terbaru yang ada dan membandingkan versinya dengan versi saat ini. Jika versi tidak cocok, dialog akan ditampilkan menanyakan apakah Anda ingin memperbarui file secara otomatis.

Contoh

Dalam contoh ini, ada dua paket Delphi (Dampackage dan DamdesignPackage). Paket waktu desain (DamDesignPackage) dikonfigurasi untuk menginstal ke Delphi IDE. Paket Runtime (Dampackage) dikonfigurasi untuk menyalin file formulir DFM dan file sumber daya untuk merilis folder.

 [Template]
IniVersion=2

[General]
Name=Dam Component
Version=1.0
DelphiVersions=XE2;XE3;XE4;XE5;XE6;XE7;XE8;10;10.1;10.2;10.3;10.4
Packages=DamPackage;DamDesignPackage
AddLibrary=1
OutputPath=Library{PLATFORM}{CONFIG}

[P_DamPackage]
Path=SourceCode
Allow64bit=1
PublishFiles=DamDialog.dfm;ResourcesDam_Resource.res

[P_DamDesignPackage]
Install=1

Periksa komponen Delphi saya di sini di GitHub dan temukan file compinstall.ini untuk melihat contoh penggunaan orang lain.