Activiti

Aktivitas

Beranda: http://activiti.org

Activiti adalah Platform alur kerja dan Manajemen Proses Bisnis (BPM) ringan yang ditargetkan untuk pebisnis, pengembang, dan admin sistem. Intinya adalah mesin proses BPMN 2 yang super cepat dan kokoh untuk Java. Ini bersumber terbuka dan didistribusikan di bawah lisensi Apache. Activiti berjalan di aplikasi Java apa pun, di server, di cluster, atau di cloud. Ini terintegrasi sempurna dengan Spring, sangat ringan dan berdasarkan konsep sederhana.

* *CATATAN: Kami memindahkan ke cabang master semua konten cabang pengembangan yang kami gunakan untuk merancang dan mengkodekan versi utama proyek berikutnya. Jika Anda ingin berkontribusi dengan versi 6.x silakan lihat di cabang 6.x.**

Jika Anda ingin membaca lebih lanjut tentang struktur Repositori kami, Anda dapat membaca GitBook kami.

Mengonfigurasi IntelliJ

• Paksa bahasa level 21, agar cepat gagal ketika (secara tidak sengaja) menggunakan fitur yang hanya tersedia di versi Java yang lebih baru.

  • Buka menu File , item menu Struktur Proyek
  • Klik item daftar Modul , untuk setiap modul, tab Sumber , kotak kombo Tingkat bahasa harus diatur secara otomatis ke 21 ...

• Hindari perubahan pada beberapa sumber daya diabaikan pada proses/debug berikutnya (dan Anda terpaksa menggunakan mvn)

  • Buka menu File , item menu Pengaturan atau menu IntelliJ IDEA , item menu Preferensi... jika di Mac
  • Klik item pohon Compiler , bidang teks Pola sumber daya : ubah menjadi !?*.java (hapus konten lainnya)

• Hindari StackOverflowError saat membangun

  • Buka menu File , item menu Pengaturan atau menu IntelliJ IDEA , item menu Preferensi... jika di Mac
  • Klik item pohon Compiler , item pohon Java Compiler , kolom teks Parameter baris perintah tambahan
  • Tambahkan -J-Xss1024k

• Gaya kode yang disarankan: gunakan Google Java Style Guide dengan editorconfig

  • Unduh xml gaya kode IntelliJ dari: [https://google.github.io/styleguide/intellij-java-google-style.xml]
  • Buka menu File , item menu Pengaturan atau menu IntelliJ IDEA , item menu Preferensi... jika di Mac
  • Klik item pohon Code Style , klik cogwheel dan pilih Impor skema , lalu IntelliJ code style xml
  • Telusuri tempat Anda mengunduh xml dan buka. Periksa apakah GoogleStyle adalah skema yang aktif.
    • Catatan: IntelliJ IDEA tidak memformat kode Anda secara otomatis. Anda harus menekan kombinasi keyboard Ctrl+Alt+L untuk memicu pemformatan otomatis saat pengkodean selesai.
  • Ada .editorconfig yang memiliki definisi untuk indentasi, pengkodean file, akhiran baris.
  • Jika Anda menonaktifkannya, Anda perlu mengatur pengkodean file dan jumlah spasi dengan benar secara manual.
  • Gaya kode Eclipse xml: [https://google.github.io/styleguide/eclipse-java-google-style.xml]
  • Eclipse memerlukan plugin editorconfig-Eclipse untuk mendukung file EditorConfig.

• Atur secara manual pengkodean file yang benar (UTF-8 kecuali untuk file properti) dan karakter akhir baris (unix):

  • Buka menu File , item menu Pengaturan atau menu IntelliJ IDEA , item menu Preferensi... jika di Mac
  • Klik item pohon Kode Gaya , item pohon Umum
    • Pemisah Garis Combobox (untuk file baru) : Unix
  • Klik item pohon Pengkodean File
    • Pengkodean Global Kotak Kombo: UTF-8
    • Combobox Pengkodean default untuk file properti : ISO-8859-1
      • Catatan: file properti i18n normal harus dalam ISO-8859-1 seperti yang ditentukan oleh kontrak Java ResourceBundle .

• Atur secara manual jumlah spasi yang benar saat menekan tab:

  • Buka menu File , item menu Pengaturan atau menu IntelliJ IDEA , item menu Preferensi... jika di Mac
  • Klik item pohon Kode Gaya , item pohon Umum
  • Klik tab Java
    • Kotak centang Gunakan karakter tab : off
    • Ukuran Tab Bidang Teks : 4
    • Indentasi Bidang Teks : 4
    • Indentasi Kelanjutan Bidang Teks : 8
  • Buka tab XML
    • Kotak centang Gunakan karakter tab : off
    • Ukuran Tab Bidang Teks : 2
    • Indentasi Bidang Teks: 2
    • Indentasi Kelanjutan Bidang Teks : 4

• Setel header file yang benar (jangan sertakan @author atau javadoc yang tidak berarti):

  • Buka menu File , item menu Pengaturan atau menu IntelliJ IDEA , item menu Preferensi... jika di Mac
  • Klik item pohon Templat file , tab Termasuk , item daftar File Header
  • Hapus baris @author Nama Anda .
    • Kami tidak menerima baris @author dalam file sumber, lihat FAQ di bawah.
  • Hapus seluruh javadoc karena data yang dibuat secara otomatis tidak ada artinya.

• Tetapkan tajuk lisensi yang benar

  • Buka menu File , item menu Pengaturan atau menu IntelliJ IDEA , item menu Preferensi... jika di Mac
  • Klik item pohon Hak Cipta , item pohon Profil hak cipta
    • Klik tombol impor untuk mengimpor profil Hak Cipta
    • Pilih file: Alfresco_Software.xml
  • Klik item pohon Hak Cipta
    • Hak cipta proyek default Combobox: Alfresco Software

Pertanyaan Umum

• Mengapa Anda tidak menerima baris @author di kode sumber Anda?

  • Karena tag penulis di file java adalah mimpi buruk pemeliharaan

    • Sebagian besar salah, tidak lengkap atau tidak akurat.
    • Seringkali, ini hanya berisi penulis aslinya. Banyak file yang sepenuhnya difaktorkan ulang/diperluas oleh penulis lain.
    • Git akurat, itulah sumber kanonik untuk menemukan penulis yang benar.

  • Karena tag penulis mempromosikan kepemilikan kode , yang berdampak buruk dalam jangka panjang.

    • Jika seseorang mengerjakan sesuatu yang mereka anggap milik orang lain, mereka cenderung:
      • hanya memperbaiki apa yang ditugaskan untuk mereka perbaiki, bukan semua yang rusak
      • buang tanggung jawab jika kode itu tidak berfungsi dengan benar
      • takut menginjak kaki pemiliknya.

  • Penghargaan kepada penulis diberikan:

    • dengan Open Hub yang juga memiliki statistik
    • di antarmuka web GitHub.

Perintah pengembangan

Tambahkan tajuk Lisensi

Untuk memformat file dengan lisensi yang diperlukan:

mvn license:format

Gaya centang

Untuk memeriksa apakah gaya kode Anda mematuhi semua aturan:

mvn checkstyle:check -DskipCheckstyle=false

Lokasi

Untuk menghasilkan situs pakar:

mvn clean site site:stage

situs akan dibuat di: target/staging/index.html

CI/CD

Menjalankan Tindakan GH.

Agar PR Dependabot dapat divalidasi oleh CI, label "CI" harus ditambahkan ke PR.

Memerlukan rahasia berikut untuk ditetapkan:

Nama	Keterangan
BOT_GITHUB_TOKEN	Token untuk meluncurkan build lain di GH
BOT_GITHUB_USERNAME	Nama pengguna untuk menerbitkan PR propagasi
NEXUS_USERNAME	Nama pengguna repositori Maven internal
NEXUS_PASSWORD	Kata sandi repositori Maven internal
SLACK_NOTIFICATION_BOT_TOKEN	Token untuk memberi tahu slack jika terjadi kegagalan