KivyMD

Kivymd 2.0.0

Kivymd adalah kumpulan widget yang sesuai dengan desain material untuk digunakan dengan Kivy, kerangka kerja untuk aplikasi grafis lintas platform, yang mendukung sentuh.

Tujuan proyek ini adalah untuk memperkirakan spesifikasi desain material Google sedekat mungkin tanpa mengorbankan kemudahan penggunaan. Perpustakaan ini adalah garpu dari proyek Kivymd. Kami menemukan kekuatan dan membawa proyek ini ke tingkat yang baru.

Bergabunglah dengan proyek! Just Fork Project, bercabang dan kirimkan permintaan tarik saat patch Anda siap. Jika ada perubahan yang diperlukan, kami akan memandu Anda melalui langkah -langkah yang perlu dilakukan melalui komentar PR atau akses ke For Anda mungkin diminta untuk langsung mengirimkannya.

Jika Anda ingin menjadi pengembang proyek (izin untuk membuat cabang pada proyek tanpa bercabang untuk kolaborasi yang lebih mudah), mintalah setidaknya satu PR menyetujui dan minta. Jika Anda berkontribusi secara teratur ke proyek, peran dapat ditawarkan kepada Anda tanpa bertanya juga.

Instalasi

pip install kivymd==2.0.0

Ketergantungan:

• Kivy> = 2.3.0 (instalasi)
• Python 3.7+
• Bantal
• Materialcolor
• asynckivy

Cara menginstal

Perintah di atas akan menginstal versi rilis terbaru dari Kivymd dari PYPI.

Jika Anda ingin menginstal versi pengembangan dari Master Branch, Anda harus menentukan tautan ke ZIP Archive:

pip install https://github.com/kivymd/KivyMD/archive/master.zip

Kiat : Ganti master.zip dengan <commit hash>.zip (mis. 51b8ef0.zip ) untuk mengunduh Kivymd dari komit tertentu.

Anda juga dapat menginstal secara manual dari sumber. Cukup klon proyek dan jalankan PIP:

git clone https://github.com/kivymd/KivyMD.git --depth 1
cd KivyMD
pip install .

Kiat Kecepatan : Jika Anda tidak memerlukan riwayat komit penuh (sekitar 1,14 Gib), Anda dapat menggunakan klon dangkal ( git clone https://github.com/kivymd/KivyMD.git --depth 1 ) untuk menghemat waktu. Jika Anda memerlukan riwayat komit penuh, maka hapus --depth 1 .

Cara menggunakan dengan buildozer

 requirements = python3,
    kivy,
    https://github.com/kivymd/KivyMD/archive/master.zip,
    materialyoucolor,
    exceptiongroup,
    asyncgui,
    asynckivy

Ini akan mengunduh versi rilis terbaru dari Kivymd dari PYPI.

Jika Anda ingin menggunakan versi pengembangan dari Master Branch, Anda harus menentukan tautan ke ZIP Archive:

 requirements = kivy, https://github.com/kivymd/KivyMD/archive/master.zip

Jangan lupa untuk menjalankan buildozer android clean atau menghapus direktori .buildozer sebelum membangun jika versi diperbarui (buildozer tidak memperbarui paket yang sudah diunduh).

Di Linux

• Gunakan Buildozer secara langsung atau melalui Docker.

Di Windows 10

• Instal Ubuntu WSL dan ikuti langkah -langkah Linux.

Bangun secara otomatis melalui tindakan GitHub

• Gunakan Artemsbulgakov/buildozer-action@V1 untuk membangun paket Anda secara otomatis berdasarkan permintaan dorong atau tarik.
• Lihat contoh alur kerja lengkap.

Cara menggunakan dengan kivy-ios

toolchain build python3 kivy pillow
toolchain pip install --no-deps kivymd

Dokumentasi

• Lihat Dokumentasi di https://kivymd.readthedocs.io
• Wiki dengan contoh menggunakan widget kivymd: https://github.com/kivymd/kivymd/wiki

Demo

Aplikasi wastafel dapur menunjukkan setiap widget Kivymd. Anda dapat melihat cara menggunakan widget dalam kode aplikasi.

Perbandingan Flutter & Kivymd

Konsep Sky View	Pengiriman makanan sehat
Konsep sepatu ASICS	Desktop Redesign Facebook

Gunakan MVC dan Hot Reload

Mendukung

Jika Anda memerlukan bantuan atau Anda memiliki pertanyaan, Anda dapat meminta bantuan di milis kami:

• Discord Server: https://discord.gg/wu3qbst (bahasa Inggris #support, Rusia #ru-support)
• Tag Stackoverflow: Kivymd
• Email: [email protected]

Pengaturan

Sintaksis Sintaksis dan Pelengkapan Otomatis untuk File Kivy/Kivymd dalam Ide Pycharm/IntelliJ

Video promo

Berkontribusi

Kami selalu menyambut laporan bug Anda, permintaan fitur, dan permintaan tarik! Lihat Kontribusi.MD dan jangan ragu untuk meningkatkan Kivymd.

Lingkungan Pengaturan

Kami menyarankan Anda untuk menggunakan Pycharm untuk bekerja dengan KivyMD Code. Instal Kivy dan Development Dependency ke lingkungan virtual Anda:

pip install -e .[dev,docs]
pre-commit install

Format semua file dan jalankan tes:

pre-commit run --all-files
pytest kivymd/tests --timeout=600 --cov=kivymd --cov-report=term

Pra-berkomitmen akan memformat file yang dimodifikasi dengan impor hitam dan mengurutkan dengan Isort.

Proyek Sister

Ekstensi Kivymd

Ekstensi tambahan untuk Perpustakaan Kivymd.

https://github.com/kivymd-extensions

Kivymdbuilder

Bangun aplikasi secara visual.

https://github.com/kivymd/kivymdbuilder

Lisensi

• Kivymd dirilis di bawah ketentuan lisensi MIT, sama seperti Kivy.
• Roboto Font dilisensikan dan didistribusikan berdasarkan ketentuan lisensi Apache, versi 2.0.
• Font ikonik oleh komunitas ikon desain material yang dicakup oleh lisensi font terbuka SIL 1.1

Kontributor

Tim Kivymd

Mereka menghabiskan banyak waktu untuk meningkatkan Kivymd.

• Yuri Ivanov @heatTheatr - Pengembang inti
• Artem Bulgakov @Artemsbulgakov - Administrator Teknis, Kontributor
• Andrés Rodríguez @Mixedcase - Penulis Pertama Proyek Kivymd, Kontributor

Kontributor Kode

Proyek ini ada berkat semua orang yang berkontribusi. Bagaimana berkontribusi

Kontributor Keuangan

Menjadi kontributor keuangan di OpenCollective dan membantu kami mempertahankan komunitas kami.

Sponsor emas

Menjadi sponsor emas dan dapatkan logo Anda di readme kami dengan tautan ke situs web Anda.

Perencana Rute Terbaik - Perangkat Lunak Optimalisasi Rute

Pendukung

Menjadi pendukung jika Anda ingin membantu mengembangkan proyek ini.