{"title":"Tutorial lanjut: Bagaimana menulis aplikasi digunakan kembali","version":"5.0","locale":"id","docname":"intro/reusable-apps","url":"/id/5.0/intro/reusable-apps/","canonical":"https://djangodocs.dev/id/5.0/intro/reusable-apps/","summary":"This advanced tutorial begins where Tutorial 8 left off. We'll be turning our web-poll into a standalone Python package you can reuse in new projects and share with…","html":"

Tutorial lanjut: Bagaimana menulis aplikasi digunakan kembaliLink to this heading#

\n

This advanced tutorial begins where Tutorial 8\nleft off. We'll be turning our web-poll into a standalone Python package\nyou can reuse in new projects and share with other people.

\n

Jika anda belum melengkapi Tutorial 1–7, kami mendorong anda meninjau ini sehingga proyek contoh anda cocok satu yang digambarkan dibawah.

\n
\n

Hal-hal dapat digunakan kembaliLink to this heading#

\n

Adalah pekerjaan banyak untuk merancang, membangun, mencoba dan merawat aplikasi jaringan. Banyak proyek Phyton dan Django berbagi masalah umum. Bukankah bagus jika kami dapat menyimpan beberapa pekerjaan berulang ini?

\n

Dapat digunakan kembali adalah cara hidup dalam Python. The Python Package Index (PyPI) memiliki jangkauan luas dari paket-paket anda dapat gunakan dalam program Python anda. Periksa Django Packages untuk aplikasi-aplikasi yang dapat digunakan kembali yang anda anda dapat bekerjasama dalam proyek anda. Django itu sendiri merupakan paket biasa Python. Ini berarti bahwa anda dapat mengambil paket Python yang ada atau aplikasi Django dan menyusun mereka kedalam proyek jaringan anda sendiri. Anda hanya butuh menulis bagian yang membuat proyek anda unik.

\n

Mari kita katakan anda sedang memulai proyek baru yang butuh aplikasi jejak pendapat seperti satu yang kite telah kerjakan. Bagaimana anda ingin membuat aplikasi ini dapat digunakan kembali? Untungnya, anda sudah sedang dalam perjalanan. Dalam Tutorial 1, kai lihat bagaimana kami dapat memisahkan jejak pendapat dari URLconf tingkat-proyek menggunakan include. Dalam tutorial ini, kami akan mengambil langkah lebih jauh untuk membuat aplikasi lebih mudah digunakan dalam proyek baru dan siap untuk diterbitkan untuk lainnya untuk dipasang dan digunakan.

\n\n
\n
\n

Proyek anda dan aplikasi digunakan kembali andaLink to this heading#

\n

After the previous tutorials, our project should look like this:

\n
Text
mysite/\n    manage.py\n    mysite/\n        __init__.py\n        settings.py\n        urls.py\n        asgi.py\n        wsgi.py\n    polls/\n        __init__.py\n        admin.py\n        apps.py\n        migrations/\n            __init__.py\n            0001_initial.py\n        models.py\n        static/\n            polls/\n                images/\n                    background.png\n                style.css\n        templates/\n            polls/\n                detail.html\n                index.html\n                results.html\n        tests.py\n        urls.py\n        views.py\n    templates/\n        admin/\n            base_site.html\n
\n

Anda membuat mysite/template di doc:Tutorial 7 </intro/tutorial07>`, dan ``polls/templates` di :doc: Tutorial 3 </intro/tutorial03>`. Sekarang tampak lebih jelas mengapa kita memilih direktori templat yang berbeda untuk project dan aplikasi: semua yang merupakan bagian aplikasi polls di dalam ``polls`. Hal ini membuat aplikasi berdiri-sendiri dan lebih mudah untuk membuat projek baru.

\n

Direktori polls sekarang dapat disalin kedalam proyek Django baru dan segera digunakan kembali. Dia tidak siap untuk diterbitkan. Untuk itu, kami butuh untuk memaketkan aplikasi agar membuatnya mudah untuk lainnya dipasang.

\n
\n
\n

Memasang beberapa prasyaratLink to this heading#

\n

The current state of Python packaging is a bit muddled with various tools. For\nthis tutorial, we're going to use setuptools to build our package. It's\nthe recommended packaging tool (merged with the distribute fork). We'll\nalso be using pip to install and uninstall it. You should install these\ntwo packages now. If you need help, you can refer to how to install\nDjango with pip. You can install setuptools\nthe same way.

\n
\n
\n

Memaketkan aplikasi andaLink to this heading#

\n

Pemaketan Phyton mengacu pada menyiapkan aplikasi anda di bentuk khusus yang dapat mudah dipasang dan digunakan. Django itu sendiri dipaketkan seperti ini. Untuk aplikasi jecil seperti jejak pendapat, pengolahan ini tidak terlalu sulit.

\n
    \n

  1. First, create a parent directory for the package, outside of your Django\nproject. Call this directory django-polls.

    \n\n
    2. \n

  2. Move the polls directory into django-polls directory, and rename it\nto django_polls.

    3. \n

  3. Edit django_polls/apps.py so that name refers to the\nnew module name and add label to give a short name for\nthe app:

    \n
    django-polls/django_polls/apps.py
    \n
    Python
    from django.apps import AppConfig\n\n\nclass PollsConfig(AppConfig):\n    default_auto_field = "django.db.models.BigAutoField"\n    name = "django_polls"\n    label = "polls"\n
    \n
    4. \n

  4. Buat berkas django-polls/README.rst dengan isi berikut:

    \n
    django-polls/README.rst
    \n
    Rst
    ============\ndjango-polls\n============\n\ndjango-polls is a Django app to conduct web-based polls. For each\nquestion, visitors can choose between a fixed number of answers.\n\nDetailed documentation is in the "docs" directory.\n\nQuick start\n-----------\n\n1. Add "polls" to your INSTALLED_APPS setting like this::\n\n    INSTALLED_APPS = [\n        ...,\n        "django_polls",\n    ]\n\n2. Include the polls URLconf in your project urls.py like this::\n\n    path("polls/", include("django_polls.urls")),\n\n3. Run ``python manage.py migrate`` to create the models.\n\n4. Start the development server and visit the admin to create a poll.\n\n5. Visit the ``/polls/`` URL to participate in the poll.\n
    \n
    5. \n

  5. Buat berkas django-polls/LICENSE. Memilih lisensi diluar lingkup dari tutorial ini, tetapi mencukupinya untuk dikatakan bahwa kode diterbitkan umum tanpa lisensi adalah tidak berguna. Django dan banyak aplikasi Sesuai-Django disebarkan dibawah lisensi BSD; bagaimanapun, anda bebas mengambil lisensi anda sendiri. Hanya waspada bahwa pilihan lisensi anda akan mempengaruhi siapa yang dapat menggunakan kode anda.

    6. \n

  6. Selanjutnya kami akan membuat berkas pyproject.toml, setup.cfg, dan setup.py yang merinci bagaimana membangun dan memasang aplikasi. Penjelasan penuh dari berkas ini diluar cakupan tutorial, tetapi setuptools documentation mempunyai penjelasan yang bagus. Buat berkas django-polls/pyproject.toml, django-polls/setup.cfg, dan django-polls/setup.py dengan isi berikut:

    \n
    django-polls/pyproject.toml
    \n
    Toml
    [build-system]\nrequires = ['setuptools>=40.8.0']\nbuild-backend = 'setuptools.build_meta'\n
    \n
    django-polls/setup.cfg
    \n
    Ini
    [metadata]\nname = django-polls\nversion = 0.1\ndescription = A Django app to conduct web-based polls.\nlong_description = file: README.rst\nurl = https://www.example.com/\nauthor = Your Name\nauthor_email = yourname@example.com\nlicense = BSD-3-Clause  # Example license\nclassifiers =\n    Environment :: Web Environment\n    Framework :: Django\n    Framework :: Django :: X.Y  # Replace "X.Y" as appropriate\n    Intended Audience :: Developers\n    License :: OSI Approved :: BSD License\n    Operating System :: OS Independent\n    Programming Language :: Python\n    Programming Language :: Python :: 3\n    Programming Language :: Python :: 3 :: Only\n    Programming Language :: Python :: 3.10\n    Programming Language :: Python :: 3.11\n    Programming Language :: Python :: 3.12\n    Topic :: Internet :: WWW/HTTP\n    Topic :: Internet :: WWW/HTTP :: Dynamic Content\n\n[options]\ninclude_package_data = true\npackages = find:\npython_requires = >=3.10\ninstall_requires =\n    Django >= X.Y  # Replace "X.Y" as appropriate\n
    \n
    django-polls/setup.py
    \n
    Python
    from setuptools import setup\n\nsetup()\n
    \n
    7. \n

  7. Only Python modules and packages are included in the package by default. To\ninclude additional files, we'll need to create a MANIFEST.in file. The\nsetuptools docs referred to in the previous step discuss this file in\nmore detail. To include the templates, the README.rst and our\nLICENSE file, create a file django-polls/MANIFEST.in with the\nfollowing contents:

    \n
    django-polls/MANIFEST.in
    \n
    Text
    include LICENSE\ninclude README.rst\nrecursive-include django_polls/static *\nrecursive-include django_polls/templates *\n
    \n
    8. \n

  8. It's optional, but recommended, to include detailed documentation with your\napp. Create an empty directory django-polls/docs for future\ndocumentation. Add an additional line to django-polls/MANIFEST.in:

    \n
    Text
    recursive-include docs *\n
    \n

    Catat bahwa direktori docs tidak akan disertakan dalam paket anda meskipun anda menambahkan beberapa berkas ke dalamnya. Banyak aplikasi Django juga menyediakan dokumentasi darin mereka melalui situs seperti readthedocs.org.

    \n
    9. \n

  9. Try building your package by running python setup.py sdist inside\ndjango-polls. This creates a directory called dist and builds your\nnew package, django-polls-0.1.tar.gz.

    10. \n
\n

Untuk informasi lebih pada pemaketan, lihat Tutorial on Packaging and Distributing Projects Python.

\n
\n
\n

Menggunakan paket anda sendiriLink to this heading#

\n

Sejak kami memindahkan direktori polls diluar proyek, dia tidak lagi bekerja. Kami akan sekarang memperbaiki ini dengan memasang paket django-polls baru.

\n\n
    \n

  1. To install the package, use pip (you already installed it, right?):

    \n
    Shell
    python -m pip install --user django-polls/dist/django-polls-0.1.tar.gz\n
    \n
    2. \n

  2. Update mysite/settings.py to point to the new module name:

    \n
    Code
    INSTALLED_APPS = [\n    "django_polls.apps.PollsConfig",\n    ...,\n]\n
    \n
    3. \n

  3. Update mysite/urls.py to point to the new module name:

    \n
    Code
    urlpatterns = [\n    path("polls/", include("django_polls.urls")),\n    ...,\n]\n
    \n
    4. \n

  4. Run the development server to confirm the project continues to work.

    5. \n
\n
\n
\n

Keluarkan aplikasi andaLink to this heading#

\n

Sekarang bahwa kita telah memaketkan dan mengujikan django-polls, dia sudah siap dibagi dengan dunia! Jika ini bukan contoh, anda dapat melakukannya sekarang:

\n\n
\n
\n

Menginstal paket Python dengan lingkungan virtualLink to this heading#

\n

Earlier, we installed django-polls as a user library. This has some\ndisadvantages:

\n\n

Khususnya, keadaan ini dapat hanya muncul ketika anda sedang merawat beberapa proyek Django. Ketika mereka melakukannya, pemecahan terbaik adalah menggunakan venv. Alat ini mengizinkan anda merawat banyak lingkungan Python terpencil, masing-masing dengan salinannya sendiri dari pustaka dan paket namespace.

\n
","rootId":"advanced-tutorial-how-to-write-reusable-apps","toc":[{"title":"Hal-hal dapat digunakan kembali","anchor":"reusability-matters","children":[]},{"title":"Proyek anda dan aplikasi digunakan kembali anda","anchor":"your-project-and-your-reusable-app","children":[]},{"title":"Memasang beberapa prasyarat","anchor":"installing-some-prerequisites","children":[]},{"title":"Memaketkan aplikasi anda","anchor":"packaging-your-app","children":[]},{"title":"Menggunakan paket anda sendiri","anchor":"using-your-own-package","children":[]},{"title":"Keluarkan aplikasi anda","anchor":"publishing-your-app","children":[]},{"title":"Menginstal paket Python dengan lingkungan virtual","anchor":"installing-python-packages-with-a-virtual-environment","children":[]}],"breadcrumbs":[{"docname":"intro/index","title":"Mulai","url":"/id/5.0/intro/"}],"prev":{"docname":"intro/tutorial08","title":"Writing your first Django app, part 8","url":"/id/5.0/intro/tutorial08/"},"next":{"docname":"intro/whatsnext","title":"Apa yang akan dibaca selanjutnya","url":"/id/5.0/intro/whatsnext/"},"formats":{"html":"/id/5.0/intro/reusable-apps/","markdown":"/id/5.0/intro/reusable-apps.md","json":"/id/5.0/intro/reusable-apps.json"},"source":"https://github.com/django/django/blob/stable/5.0.x/docs/intro/reusable-apps.txt","official":"https://docs.djangoproject.com/id/5.0/intro/reusable-apps/","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","it","pt-br","ko","es","el","pl"]}