Menyediakan aplikasi desktop

Cara memasang aplikasi desktop Antimatter pada komputer syarikat atau sekolah, serta menetapkan pelayan, nama pengguna dan semakan kemas kini secara berpusat pada Windows, macOS dan Linux.

Muat turun aplikasi

Pelepasan aplikasi desktop terdapat di GitHub, di github.com/AntimatterChat/desktop-app/releases. Seperti pelayan, aplikasi ini masih dalam beta: pelepasan yang mempunyai sufiks selepas tanda sengkang pada versinya ditandakan Pre-release. Setiap pelepasan mempunyai fail SHA256SUMS yang mengandungi checksum bagi setiap fail. Semak muat turun dengan sha256sum --check --ignore-missing SHA256SUMS pada Linux, atau bandingkan output Get-FileHash <file> -Algorithm SHA256 dalam PowerShell dengan baris yang sepadan dalam SHA256SUMS.

• Windows (x64 dan arm64): pemasang .exe, pakej .msi, atau arkib .zip. Contohnya antimatter-desktop-<version>-win-x64.exe dan antimatter-desktop-<version>-win-x64.msi.
• macOS: imej cakera .dmg atau .zip, untuk Apple silicon (arm64), Mac Intel (x64) atau kedua-duanya (universal).
• Linux (x64 dan arm64): pakej .deb atau .rpm, AppImage, bundel Flatpak atau arkib .tar.gz.

Pemasang Windows yang perlu digunakan

Aplikasi ini memeriksa versi baharu di GitHub setiap jam semasa ia berjalan, dan hanya melihat pelepasan penuh, bukan prapelepasan. Apabila ia menemui satu, ia memaklumkan pengguna dan menawarkan pautan untuk memuat turunnya. Salinan yang dipasang dengan MSI tidak memeriksa secara lalai, kerana pengguna biasanya tidak dapat memasang perisian. Anda boleh memulakan pemeriksaan untuknya dengan tetapan EnableAutoUpdater: muat turun yang ditawarkan kemudian ialah .msi baharu, yang memerlukan kebenaran pentadbir.

Gunakan MSI untuk pelaburan yang diurus dengan SCCM (Configuration Manager), Intune atau pemasangan perisian Dasar Kumpulan. Memasang MSI akan memadam salinan .exe bagi akaun yang menjalankan pemasangan, jika ada.

Tetapan yang boleh anda urus

Tetapan yang sama wujud pada setiap sistem. Pada Windows, ia adalah nilai registri di bawah SOFTWARE\Policies\Antimatter, dalam HKEY_LOCAL_MACHINE (untuk komputer) atau HKEY_CURRENT_USER (untuk satu pengguna). Pada macOS dan Linux, ia adalah kunci bagi preferensi yang diurus atau bagi fail dasar.

• Nama pengguna hanya diisi pada halaman log masuk bagi pelayan yang ditetapkan oleh dasar, tidak pernah pada pelayan yang ditambah oleh pengguna, dan tidak pernah menimpa apa yang diketik oleh seseorang. Pengguna masih boleh mengubahnya. Pemboleh ubah persekitaran di antara tanda peratus diganti, jadi satu nilai sesuai untuk semua: %USERNAME% pada Windows atau %USER% pada macOS dan Linux memberikan nama akaun, dan %USERNAME%@example.com memberikan alamat e-mel yang mengikuti corak ini. Jika pemboleh ubah tidak ditetapkan, aplikasi tidak mengisi apa-apa.
• Jika anda mematikan pengurusan pelayan, tetapkan sekurang-kurangnya satu pelayan dalam DefaultServerList.
• Pada Windows, dasar komputer (HKEY_LOCAL_MACHINE) menang ke atas dasar pengguna (HKEY_CURRENT_USER). Senarai pelayan bagi kedua-duanya digabungkan.
• Aplikasi membaca tetapan apabila ia bermula: selepas perubahan, pengguna mesti keluar dan membukanya semula.

Windows: pemasangan senyap dengan MSI

MSI mengambil harta awam yang menulis tetapan sebagai dasar komputer, dalam HKEY_LOCAL_MACHINE\SOFTWARE\Policies\Antimatter. Gunakan mereka dalam aplikasi SCCM, aplikasi Intune atau skrip. Dalam PowerShell:

msiexec /i antimatter-desktop-<version>-win-x64.msi /qn SERVERURL=https://chat.example.com SERVERNAME=Chat DEFAULTUSERNAME='%USERNAME%' AUTOUPDATE=0 SERVERMANAGEMENT=0

• Harta yang tidak diberikan tidak menulis apa-apa, jadi ia tidak menimpa nilai yang ditetapkan oleh Group Policy. AUTOUPDATE dan SERVERMANAGEMENT hanya menerima 0 atau 1. MSI menetapkan satu pelayan: gunakan Group Policy untuk lebih banyak.
• DEFAULTUSERNAME mesti sampai ke pemasang sebagai teks %USERNAME%, supaya aplikasi menggantikannya untuk setiap orang. Jika tidak, shell yang menjalankan pemasangan akan menggantikannya dengan nama akaunnya sendiri. Dalam PowerShell, kekalkan tanda petik tunggal. Dalam fail .bat, tulis %%USERNAME%%. Selepas pemasangan ujian, semak dalam registri bahawa DefaultUsername memegang %USERNAME%.
• Lalukan harta sekali lagi pada setiap peningkatan. Memasang versi baharu MSI akan memadam yang lama, dengan nilai yang ditulisnya, kemudian menulis nilai baris arahan baharu. SCCM dan Intune menyimpan baris arahan aplikasi: gunakan semula untuk setiap versi baharu. Atau tetapkan dasar dengan Group Policy atau Intune sebaliknya, yang tidak disentuh oleh peningkatan.
• MSI dan Dasar Kumpulan menulis nilai registri yang sama. Untuk setiap tetapan, gunakan salah satu: membatalkan pemasangan MSI akan memadam nilai yang ditulisnya, walaupun Dasar Kumpulan juga telah menetapkannya.
• MSI juga merekodkan folder pemasangannya dalam HKEY_LOCAL_MACHINE\SOFTWARE\Antimatter\Desktop (InstallDir). Ini adalah cara aplikasi mengetahui bahawa ia dipasang menggunakan MSI.

Untuk membatalkan pemasangan: msiexec /x antimatter-desktop-<version>-win-x64.msi /qn. Dalam Intune, jenis "Windows app (Win32)" menerima baris arahan yang sama. Untuk jenis "Line-of-business app", tambah sifat-sifat tersebut ke dalam argumen baris arahnya.

Windows: Dasar Kumpulan dan Intune

Templat pentadbiran, antimatter.admx dan en-US\antimatter.adml, berada dalam folder gpo aplikasi yang dipasang (C:\Program Files\Antimatter\gpo untuk MSI), dan dalam folder resources/windows/gpo dalam repositori aplikasi. Ia menunjukkan dasar-dasar ini, di bawah Administrative Templates › Antimatter:

Dasar Kumpulan dalam domain

1. Salin antimatter.admx ke stor pusat, \\<domain>\SYSVOL\<domain>\Policies\PolicyDefinitions, dan antimatter.adml ke folder en-US miliknya.
2. Dalam Editor Pengurusan Dasar Kumpulan, buka Computer Configuration (atau User Configuration) › Policies › Administrative Templates › Antimatter.
3. Sunting dasar, pilih Dihidupkan dan isikannya. Untuk Servers, klik Tunjuk dan tambah satu baris untuk setiap pelayan: nama nilai ialah nama tab, nilai ialah URL pelayan, seperti https://chat.example.com.

Menghidupkan Let people add and remove servers atau Notify about new versions menulis 1; mematikannya menulis 0.

Intune

Dalam Peranti › Konfigurasi, gunakan Import ADMX untuk mengimport antimatter.admx bersama en-US\antimatter.adml. Kemudian, cipta profil daripada Templat › Templat Pentadbiran Diimport, dan tetapkan dasar Antimatter di dalamnya.

Satu komputer, atau skrip

Salin templat ke C:\Windows\PolicyDefinitions untuk menggunakannya dalam gpedit.msc (Windows Pro dan Enterprise). Atau tulis nilai registri secara langsung, dengan fail .reg yang diimport sebagai pentadbir (reg import antimatter-policies.reg), seperti yang berikut. Fail example-policies.reg dalam folder yang sama mempunyai nilai-nilai ini, dengan komen.

REGEDIT4

[HKEY_LOCAL_MACHINE\SOFTWARE\Policies\Antimatter]
"EnableServerManagement"=dword:00000000
"EnableAutoUpdater"=dword:00000000
"DefaultUsername"="%USERNAME%"

[HKEY_LOCAL_MACHINE\SOFTWARE\Policies\Antimatter\DefaultServerList]
"Chat"="https://chat.example.com"

macOS: profil konfigurasi

Pada macOS, aplikasi membaca tetapan daripada preferensi terurus bagi pengenal pasti bundelnya, chat.antimatter.desktop, dengan kunci daripada jadual tetapan. Sebarkannya dengan MDM anda (Jamf, Intune, Kandji, Mosyle dan lain-lain) sebagai profil konfigurasi.

• Folder resources/mac/mdm dalam repositori aplikasi mempunyai profil contoh, antimatter.mobileconfig. Edit nilainya, berikan nilai PayloadIdentifier dan PayloadUUID anda sendiri (uuidgen menghasilkan UUID baharu), dan muat naik sebagai profil khusus.
• Kebanyakan MDM juga menerima kunci sahaja, sebagai muatan "tetapan khusus" atau "domain preferensi" untuk chat.antimatter.desktop. Folder yang sama mempunyai kunci-kunci ini dalam example-managed-preferences.plist.

Tetapan di dalam muatan profil:

<key>PayloadType</key>
<string>chat.antimatter.desktop</string>
<key>DefaultServerList</key>
<array>
    <dict>
        <key>name</key>
        <string>Chat</string>
        <key>url</key>
        <string>https://chat.example.com</string>
    </dict>
</array>
<key>DefaultUsername</key>
<string>%USER%</string>
<key>EnableServerManagement</key>
<false/>
<key>EnableAutoUpdater</key>
<false/>

Nilai bolean juga boleh diberikan sebagai integer 0 dan 1.

Linux: fail dasar

Pada Linux, aplikasi membaca /etc/antimatter-desktop/policies.json, objek JSON dengan kunci daripada jadual tetapan:

{
    "DefaultServerList": [
        {"name": "Chat", "url": "https://chat.example.com"}
    ],
    "DefaultUsername": "%USER%",
    "EnableServerManagement": false,
    "EnableAutoUpdater": false,
    "TrustedEmbeddedMediaOrigins": []
}

Sebarkannya dengan alat pengurusan konfigurasi anda (Ansible, Puppet, Salt dan lain-lain), dimiliki oleh root, boleh dibaca oleh semua orang dan boleh ditulis hanya oleh root:

sudo install -d /etc/antimatter-desktop
sudo install -m 644 policies.json /etc/antimatter-desktop/policies.json

Fail yang bukan JSON sahaja akan diabaikan, dengan amaran dalam log aplikasi. Versi Flatpak tidak melihat /etc hos: berikan akses baca, dan ia akan membaca fail dari /run/host/etc/antimatter-desktop/policies.json:

sudo flatpak override --system --filesystem=host-etc:ro chat.antimatter.desktop

Dasar yang ditetapkan untuk aplikasi desktop Mattermost

Pada Windows, aplikasi juga membaca dasar yang ditetapkan untuk aplikasi desktop Mattermost, di bawah SOFTWARE\Policies\Mattermost, sebagai cadangan. Ia membacanya mengikut lokasi: nilai yang berada terus di bawah kunci dasar, subkunci DefaultServerList dan subkunci TrustedEmbeddedMediaOrigins. Untuk setiap tiga lokasi ini, ia hanya membaca kunci Mattermost apabila kunci Antimatter tiada nilai di sana, dalam mana-mana hive. Jadi, sebaik sahaja satu nilai ditetapkan terus di bawah kunci Antimatter, contohnya melalui sifat AUTOUPDATE MSI, tiada nilai yang berada terus di bawah kunci Mattermost akan dibaca. Pindahkan semua dasar anda ke kunci Antimatter serentak.

Pada macOS, preferensi pengurusan untuk aplikasi desktop Mattermost (com.mattermost.desktop) tidak dibaca: tetapkannya untuk chat.antimatter.desktop.

Binaan tanpa tandatangan

Binaan aplikasi desktop ini belum ditandatangani dengan sijil penerbit.

• Windows. Apabila seseorang membuka .exe atau .msi yang dimuat turun, Microsoft Defender SmartScreen menyatakan bahawa Windows telah melindungi komputer dan menamakan penerbit yang tidak dikenali. Mereka memilih Maklumat Lanjut, kemudian jalankan juga. SmartScreen memeriksa fail yang dibuka orang selepas muat turun, jadi orang tidak akan melihat amaran ini apabila anda mengedarkan aplikasi melalui SCCM, Intune atau Group Policy. Jika komputer anda hanya menjalankan perisian daripada penerbit yang diluluskan (peraturan AppLocker atau App Control for Business), benarkan aplikasi melalui laluan pemasangan atau hash fail.
• macOS. Aplikasi ini ditandatangani secara ad hoc, tetapi tidak dinotaris oleh Apple. Pada kali pertama seseorang membuka salinan yang dimuat turun, macOS menyatakan bahawa ia tidak dapat mengesahkan bahawa aplikasi bebas daripada perisian rosak, dan tidak membukanya. Pada macOS 15 dan kemudian, mereka membuka Tetapan Sistem › Privasi & Keselamatan dan memilih buka juga. Pada versi sebelumnya, mereka klik-kawalan aplikasi dan memilih buka. Gatekeeper hanya memeriksa fail yang ditanda sebagai dimuat turun (dengan atribut kuarantin): apabila anda memasang aplikasi dengan alat anda sendiri, buang tanda dalam skrip pemasangan anda, dengan xattr -dr com.apple.quarantine /Applications/Antimatter.app.