{"title":"Aplikasi","version":"3.1","locale":"id","docname":"ref/applications","url":"/id/3.1/ref/applications/","canonical":"https://djangodocs.dev/id/3.1/ref/applications/","summary":"Django mengandung sebuah registrar dari aplikasi terpasang yang menyimpan konfigurasi dan menyediakan introspeksi.","html":"

AplikasiLink to this heading#

\n

Django mengandung sebuah registrar dari aplikasi terpasang yang menyimpan konfigurasi dan menyediakan introspeksi. Dia juga merawat daftar dari ketersediaan models.

\n

Registri disebut apps dan tersedia dalam django.apps:

\n
Code
>>> from django.apps import apps\n>>> apps.get_app_config('admin').verbose_name\n'Administration'\n
\n
\n

Proyek dan aplikasiLink to this heading#

\n

The term project describes a Django web application. The project Python\npackage is defined primarily by a settings module, but it usually contains\nother things. For example, when you run django-admin startproject mysite\nyou'll get a mysite project directory that contains a mysite Python\npackage with settings.py, urls.py, asgi.py and wsgi.py. The\nproject package is often extended to include things like fixtures, CSS, and\ntemplates which aren't tied to a particular application.

\n

Sebuah direktori akar proyek (satu yang mengandung manage.py) biasanya mengandung semua aplikasi proyek yang tidak dipasang secara terpisah.

\n

Istilah aplikasi menggambarkan paket Python yang menyediakan beberapa kumpulan fitur. Aplikasi may be reused di beragam proyek.

\n

Aplikasi menyertakan beberapa kombinasi model, tampilan, cetakan, etiket cetakan, berkas tetap, URL, middleware, dll. Mereka umumnya diikat kedalam proyek dengan pengaturan INSTALLED_APPS dan secara pilihan dengan mekanisme lain seperti URLconf, pengaturan MIDDLEWARE, atau warisan cetakan.

\n

It is important to understand that a Django application is a set of code\nthat interacts with various parts of the framework. There's no such thing as\nan Application object. However, there's a few places where Django needs to\ninteract with installed applications, mainly for configuration and also for\nintrospection. That's why the application registry maintains metadata in an\nAppConfig instance for each installed application.

\n

Tidak ada batasan bahwa sebuah paket proyek tidak dapat dianggap sebuah aplikasi dan mempunyai model, dll. (yang akan butuh menambahkannya ke INSTALLED_APPS).

\n
\n
\n

Konfigurasi aplikasiLink to this heading#

\n

Untuk mengkonfigurasi sebuah aplikasi, subkelas AppConfig dan menaruh jalur titik ke subkelas tersebut dalam INSTALLED_APPS.

\n

Ketika INSTALLED_APPS mengandung jalur bertitik pada sebuah modul aplikasi, Django memeriksa untuk variabel default_app_config dalam modul tersebut.

\n

Jika dia ditentukan, jalur bertitik ke subkelas AppConfig untuk aplikasi tersebut.

\n

Jika tidak ada default_app_config, Django menggunakan kelas dasar AppConfig.

\n

default_app_config mengizinkan aplikasi yang mendahului Django 1.7 seperti django.contrib.admin` untuk memasukkan ke fitur AppConfig tanpa membutuhkan pengguna memperbaharui INSTALLED_APPS mereka.

\n

Aplikasi baru harus menghindari default_app_config. Sebagai gantinya mereka harus butuh jalur bertitik ke subkelas AppConfig sesuai untuk di konfigurasi secara eksplisit di INSTALLED_APPS.

\n
\n

Untuk pengarang aplikasiLink to this heading#

\n

Jika anda membuat sebuah aplikasi dapat dipasang dipanggil "Rock ’n’ roll", ini adalah bagaimana anda akan menyediakan sebuah nama pantas untuk admin:

\n
Code
# rock_n_roll/apps.py\n\nfrom django.apps import AppConfig\n\nclass RockNRollConfig(AppConfig):\n    name = 'rock_n_roll'\n    verbose_name = "Rock ’n’ roll"\n
\n

Anda dapat membuat aplikasi anda memuat subkelas ini AppConfig subclass secara awal sebagai berikut:

\n
Code
# rock_n_roll/__init__.py\n\ndefault_app_config = 'rock_n_roll.apps.RockNRollConfig'\n
\n

That will cause RockNRollConfig to be used when INSTALLED_APPS\ncontains 'rock_n_roll'. This allows you to make use of\nAppConfig features without requiring your users to update\ntheir INSTALLED_APPS setting. Besides this use case, it's best to\navoid using default_app_config and instead specify the app config class in\nINSTALLED_APPS as described next.

\n

You can also tell your users to put 'rock_n_roll.apps.RockNRollConfig' in\ntheir INSTALLED_APPS setting. You can even provide several different\nAppConfig subclasses with different behaviors and allow\nyour users to choose one via their INSTALLED_APPS setting.

\n

Ketentuan yang dianjurkan adalah menaruh kelas konfigurasi di submodul dari aplikasi dipanggil apps. Bagaimanapun, ini tidak akan dipaksakan oleh Django.

\n

Anda harus menyertakan atribut name untuk Django untuk menentukan aplikasi mana konfigurasi ini berlaku. Anda dapat menentukan atribut apapun didokumentasikan di acuan API AppConfig.

\n\n
\n
\n

Untuk pengguna aplikasiLink to this heading#

\n

Jika anda menggunakan "Rock ’n’ roll" dalam proyek disebut anthology, tetapi anda ingin menampilkan "Jazz Manouche", anda dapat menyediakan konfigurasi anda sendiri:

\n
Code
# anthology/apps.py\n\nfrom rock_n_roll.apps import RockNRollConfig\n\nclass JazzManoucheConfig(RockNRollConfig):\n    verbose_name = "Jazz Manouche"\n\n# anthology/settings.py\n\nINSTALLED_APPS = [\n    'anthology.apps.JazzManoucheConfig',\n    # ...\n]\n
\n

Lagi, menentukan kelas konfigurasi proyek-khusus di submodul dipanggil apps adalah sebuah ketentuan, bukan sebuah persyaratan.

\n
\n
\n
\n

Konfigurasi aplikasiLink to this heading#

\n
\n
\nclass AppConfigLink to this definition#
\n

Konfigurasi aplikasi obyek menyimpan metadata untuk sebuah aplikasi. Beberapa atribut dapat dikonfigurasikan di subkelas AppConfig. Lainnya disetel oleh Django dan hanya-baca.

\n
\n\n
\n

Atribut dapat dikonfigurasiLink to this heading#

\n
\n
\nAppConfig.nameLink to this definition#
\n

Jalur Phyton penuh ke aplikasi, misalnya 'django.contrib.admin'.

\n

Atribut ini menentukan konfigurasi aplikasi mana yang berlaku. DIa harus disetel di semua subkelas AppConfig.

\n

Dia harus unik terhadap proyek Django.

\n
\n\n
\n
\nAppConfig.labelLink to this definition#
\n

Nama pendek untuk aplikasi, misalnya 'admin'

\n

Atribut ini mengizinkan melabel kembali sebuah aplikasi ketika dua aplikasi mempunyai label bertentangan. Awal dia ke komponen terakhir dari name. Dia harus penciri Python yang sah.

\n

Dia harus unik terhadap proyek Django.

\n
\n\n
\n
\nAppConfig.verbose_nameLink to this definition#
\n

Nama dapat dibaca manusia untuk aplikasi, misalnya "Administrasi".

\n

Atribut awal ke label.title().

\n
\n\n
\n
\nAppConfig.pathLink to this definition#
\n

Jalur sistem berkas pada direktori aplikasi, misalnya '/usr/lib/pythonX.Y/dist-packages/django/contrib/admin'.

\n

Dalam banyak kasus, Django dapat otomatis mengenali dan mengatur ini, tetapi anda dapat juga menyediakan menimpa eksplisit sebagai atribut kelas di subkelas AppConfig anda. Dalam beberapa situasi ini diwajibkan; sebagai contoh jika paket aplikasi adalah namespace package dengan banyak jalur.

\n
\n\n
\n
\n

Atribut hanya-bacaLink to this heading#

\n
\n
\nAppConfig.moduleLink to this definition#
\n

modul utama/akar untuk aplikasi, misalnya "<module 'django.contrib.admin' from 'django/contrib/admin/__init__.py'>".

\n
\n\n
\n
\nAppConfig.models_moduleLink to this definition#
\n

Modul yang berisi model, misalnya "<module 'django.contrib.admin.models' from 'django/contrib/admin/models.py'>".

\n

Itu mungkin None jika aplikasi tidak mengandung sebuah modul models. Catat bahwa basisdata terkait sinyal seperti pre_migrate dan post_migrate hanya dimunculkan untuk aplikasi yang mempunyai sebuah modul models

\n
\n\n
\n
\n

CaraLink to this heading#

\n
\n
\nAppConfig.get_models()Link to this definition#
\n

Mengembalikan kelas Model berulang untuk aplikasi ini.

\n

Membutuhkan aplikasi registrar untuk sepenuhnya dikumpulkan.

\n
\n\n
\n
\nAppConfig.get_model(model_name, require_ready=True)Link to this definition#
\n

Mengembalikan Model dengan model_name diberikan. model_name adalah tidak sensitif.

\n

Memunculkan LookupError jika tidak ada model yang ada dalam aplikasi ini.

\n

Membutuhkan aplikasi regristrar untuk sepenuhnya dikumpulkan meskipun argumen require_ready disetel menjadi False. require_ready berperilaku tepat seperti dalam apps.get_model().

\n
\n\n
\n
\nAppConfig.ready()Link to this definition#
\n

Subkelas dapat menimpa metode ini untuk melakukan tugas inisialisasi seperti mendaftarkan sinyal. Dia dipanggil segera ketika registrar dikumpulkan penuh.

\n

Meskipun anda tidak dapat mengimpor pada tingkat-modul dimana kelas-kelas AppConfig ditentukan, anda dapat mengimpor ready(), menggunakan antara pernyataan import atau get_model().

\n

Jika anda sedang mendaftarkan model signals, anda dapat mengacu pada pengirim berdasarkan label deretan karakter nya daripada menggunakan kelas model itu sendiri.

\n

Contoh:

\n
Code
from django.apps import AppConfig\nfrom django.db.models.signals import pre_save\n\n\nclass RockNRollConfig(AppConfig):\n    # ...\n\n    def ready(self):\n        # importing model classes\n        from .models import MyModel  # or...\n        MyModel = self.get_model('MyModel')\n\n        # registering signals with the model's string label\n        pre_save.connect(receiver, sender='app_label.MyModel')\n
\n\n\n
\n\n
\n
\n

Paket namespace sebagai aplikasiLink to this heading#

\n

Paket-paket Python tanpa berkas __init__.py dikenal sebagai "namespace packages" dan mungkin tersebar di banyak direktori pada tempat berbeda di sys.path (see PEP 420).

\n

Aplikasi Django membutuhkan sebuah jalus sistem berkas berbasis tunggal dimana Django (tergantung pada konfigurasi) akan mencari cetakan, aset tetap, dll. Hingga, paket namespace mungkin hanya aplikasi Django jika satu dari hal berikut adalah benar:

\n
    \n

  1. Paket namespace sebenarnya mempunyai hanya tempat tunggal (yaitu tidak tersebar terhadap lebih dari satu direktori.)

    2. \n

  2. Kelas AppConfig digunakan untuk mengkonfigurasikan aplikasi yang mempunyai atribut kelas path, yang merupakan jalur direktori mutlak Django akan digunakan sebagai jalur dasar tunggal untuk aplikasi.

    3. \n
\n

Jika tidak satupun dari kondisi ini bertemu, Django akan memunculkan ImproperlyConfigured.

\n
\n
\n
\n

Registrar aplikasiLink to this heading#

\n
\n
\nappsLink to this definition#
\n

Registrar aplikasi menyediakan API umum berikut. Cara yang tidak ada di daftar dibawah ini dianggap pribadi dan mungkin berubah tanpa pemberitahuan.

\n
\n\n
\n
\napps.readyLink to this definition#
\n

Atribut Boolean yang disetel ke True setelah registrar sepenuhnya dikumpulkan dan semua cara AppConfig.ready() dipanggil.

\n
\n\n
\n
\napps.get_app_configs()Link to this definition#
\n

Mengembalikan instance berulang dari AppConfig.

\n
\n\n
\n
\napps.get_app_config(app_label)Link to this definition#
\n

Mengembalikan sebuah AppConfig untuk aplikasi dengan app_label. yang diberikan. Memunculkan LookupError jika tidak ada aplikasi.

\n
\n\n
\n
\napps.is_installed(app_name)Link to this definition#
\n

Memeriksa apakah aplikasi dengan nama diberikan anda di registrar. app_name adalah nama penuh dari aplikasi, misalnya 'django.contrib.admin'.

\n
\n\n
\n
\napps.get_model(app_label, model_name, require_ready=True)Link to this definition#
\n

Mengembalikan Model dengan app_label yang diberikan dan model_name. Sebagai sebuah jalan pintas, metode ini juga menerima argumen tunggal dalam bentuk app_label.model_name. model_name kasus-tidak peka.

\n

Memunculkan LookupError jika tidak seperti aplikasi atau model ada. Memunculkan ValueError ketika dipanggil dengan argumen tunggal yang tidak mengandung satu titik.

\n

Membutuhkan aplikasi regristrar untuk sepenuhnya dikumpulkan meskipun argumen require_ready disetel menjadi False.

\n

Mengatur require_ready menjadi False mengizinkan pencarian model while the app registry is being populated, khususnya selama tahap kedua dimana itu mengimpor model. Kemudian get_model() mempunyai pengaruh sama ketika mengimpor model. Kasus penggunaan utama adalah mengkonfigurasi kelas-kelas model dengan pengaturan, seperti AUTH_USER_MODEL.

\n

Ketika require_ready adalah False, get_model() mengembalikan sebuah kelas model yang mungkin tidak sepenuhnya berfungsi (accessor balikan mungkin hilang, sebagai contoh) sampai aplikasi regristrar sepenuhnya dikumpulkan. Untuk alasan ini, itu adalah terbaik untuk membiarkan require_ready ke nilai awalan dari True kapanpun memungkinkan.

\n
\n\n
\n
\n

Inisialisasi pengolahanLink to this heading#

\n
\n

Bagaimana aplikasi dimuatLink to this heading#

\n

Ketika Django mulai, django.setup() bertanggung jawab untuk mengumpulkan registrar aplikasi.

\n
\n
\nsetup(set_prefix=True)Link to this definition#
\n

Konfigurasi Django oleh:

\n
    \n

  • Memuat pengaturan.

    • \n

  • Mengatur pencatatan.

    • \n

  • Jika set_prefix adalah True, pengaturan awalan tulisan penyelesai URL ke FORCE_SCRIPT_NAME jika ditentukan, atau jika tidak /.

    • \n

  • Memulai registrar aplikasi

    • \n
\n

Fungsi ini dipanggil otomatis:

\n
    \n

  • Ketika menjalankan peladen HTTP melalui dukungan WSGI Django.

    • \n

  • Ketika meminta perintah pengelolaan.

    • \n
\n

Dia harus dipanggil secara tersirat di kasus lain, sebagai contoh di tulisan Phyton.

\n
\n\n

Registrar aplikasi dimulai dalam tiga tingkatan, Pada setiap tingkatan, Django mengolah semua aplikasi berdasarkan dari INSTALLED_APPS.

\n
    \n

  1. Django pertama mengimpor setiap barang di INSTALLED_APPS.

    \n

    Jika itu sebuah kelas konfigurasi aplikasi, Django impor paket akar dari aplikasi, ditentukan oleh atribut name nya. Jika itu adalah sebuah paket Python, Django membuat konfigurasi aplikasi awal.

    \n

    Pada tingkatan ini, kode anda jangan mengimpor model apapun!

    \n

    Dengan kata lain, paket akar aplikasi anda dan modul yang menentukan kelas-kelas konfigurasi aplikasi anda jangan impor model apapun, bahkan secara tidak langsung.

    \n

    Sesungguhnya, Django mengizinkan mengimpor model sekali konfigurasi aplikasi mereka dimuat. Bagaimanapun, agar menghindari kendala yang tidak perlu pada urutan INSTALLED_APPS, sangat dianjurkan tidak mengimpor model apapun pada tingkatan ini.

    \n

    Sekali tingkatan ini lengkap, API yang menjalankan konfigurasi aplikasi seperti get_app_config() menjadi tidak berguna.

    \n
    2. \n

  2. Kemudian Django berusaha mengimpor submodul model dari setiap aplikasi, jika memang ada.

    \n

    Anda harus menentukan atau mengimpor semua model di aplikasi models.py anda atau models/__init__.py. Sebaliknya, registri aplikasi mungkin tidak dikumpulkan penuh pada titik ini, yang dapat menyebabkan ORM tidak berfungsi.

    \n

    Ketika tingkatan ini lengkap, API yang bekerja di model seperti get_model() menjadi dapat digunakan.

    \n
    3. \n

  3. Akhirnya Django menjalankan cara ready() dari setiap konfigurasi aplikasi.

    4. \n
\n
\n
\n

Menyelesaikan masalahLink to this heading#

\n

Disini beberapa masalah umum yang mungkin muncul selama inisialisasi:

\n\n
\n
","rootId":"module-django.apps","toc":[{"title":"Proyek dan aplikasi","anchor":"projects-and-applications","children":[]},{"title":"Konfigurasi aplikasi","anchor":"configuring-applications","children":[{"title":"Untuk pengarang aplikasi","anchor":"for-application-authors","children":[]},{"title":"Untuk pengguna aplikasi","anchor":"for-application-users","children":[]}]},{"title":"Konfigurasi aplikasi","anchor":"application-configuration","children":[{"title":"Atribut dapat dikonfigurasi","anchor":"configurable-attributes","children":[]},{"title":"Atribut hanya-baca","anchor":"read-only-attributes","children":[]},{"title":"Cara","anchor":"methods","children":[]},{"title":"Paket namespace sebagai aplikasi","anchor":"namespace-packages-as-apps","children":[]}]},{"title":"Registrar aplikasi","anchor":"application-registry","children":[]},{"title":"Inisialisasi pengolahan","anchor":"initialization-process","children":[{"title":"Bagaimana aplikasi dimuat","anchor":"how-applications-are-loaded","children":[]},{"title":"Menyelesaikan masalah","anchor":"troubleshooting","children":[]}]}],"breadcrumbs":[{"docname":"ref/index","title":"Acuan API","url":"/id/3.1/ref/"}],"prev":{"docname":"ref/index","title":"Acuan API","url":"/id/3.1/ref/"},"next":{"docname":"ref/checks","title":"Kerangka pemeriksaan sistem","url":"/id/3.1/ref/checks/"},"formats":{"html":"/id/3.1/ref/applications/","markdown":"/id/3.1/ref/applications.md","json":"/id/3.1/ref/applications.json"},"source":"https://github.com/django/django/blob/stable/3.1.x/docs/ref/applications.txt","official":"https://docs.djangoproject.com/id/3.1/ref/applications/","inVersions":["6.1","6.0","5.2","5.1","5.0","4.2","4.1","4.0","3.2","3.1","3.0","2.2","2.1","2.0","1.11","1.10","1.9"],"inLocales":["en","zh-hans","fr","ja","id","pt-br","ko","es","el","pl"]}