{"title":"Tutorial lanjut: Bagaimana menulis aplikasi digunakan kembali","version":"2.2","locale":"id","docname":"intro/reusable-apps","url":"/id/2.2/intro/reusable-apps/","canonical":"https://djangodocs.dev/id/2.2/intro/reusable-apps/","summary":"Tutorial lanjutan ini mulai dimana Tutorial 7 ditinggalkan. Kami akan merubah jejak pendapat Jaringan kami kedalam paket Python berdisi sendiri anda dapat gunakan…","html":"

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

\n

Tutorial lanjutan ini mulai dimana Tutorial 7 ditinggalkan. Kami akan merubah jejak pendapat Jaringan kami kedalam paket Python berdisi sendiri anda dapat gunakan kembali dalam proyek baru dan berbagi dengan orang lain.

\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

Penggunaan kembali adaah cara hidup dalam Python. The Python Package Index (PyPI) mempunyai jangkauan luas dari paket-paket anda dapat gunakan dalam program-program Python milik anda. Periksa Django Packages untuk keadaan aplikasi-aplikasi digunakan kembali anda dapat pakai dalam proyek anda. Django itu sendiri hanya sebuah paket Python. Ini berarti bahwa anda dapat mengambil paket-paket Python yang ada atai aplikasi-aplikasi Django dan menyusun mereka kedalam proyek jaringan milik anda. Anda hanya butuh menulis bagian-bagian yang membuat proyek anda unik.

\n

Let's say you were starting a new project that needed a polls app like the one\nwe've been working on. How do you make this app reusable? Luckily, you're well\non the way already. In Tutorial 1, we saw how we\ncould decouple polls from the project-level URLconf using an include.\nIn this tutorial, we'll take further steps to make the app easy to use in new\nprojects and ready to publish for others to install and use.

\n\n
\n
\n

Proyek anda dan aplikasi digunakan kembali andaLink to this heading#

\n

Setelah tutorial sebelumnya, proyek kami harusnya seperti ini:

\n
Code
mysite/\n    manage.py\n    mysite/\n        __init__.py\n        settings.py\n        urls.py\n        wsgi.py\n    polls/\n        __init__.py\n        admin.py\n        migrations/\n            __init__.py\n            0001_initial.py\n        models.py\n        static/\n            polls/\n                images/\n                    background.gif\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

Keadaan saat ini dari pemaketan Phyton adalah sedikit karut dengan alat beragam. Untuk tutorial ini, kami akan menggunakan setuptools untuk membangun paket kami. Ini adalah alat pemaketan disarankan (digabungkan dengan mengedarkan cabang). Kami akan juga menggunakan pip untuk memasan dan melepasnya. Anda harus memasang dua paket ini sekarang. Jika anda butuh bantuan, anda dapat mengacu ke how to install Django with pip. Anda dapat memasang setuptools cara sama.

\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. Pertama, buat direktori induk untuk polls, diluar dari proyek Django anda. Panggil direktori ini django-polls.

    \n\n
    2. \n

  2. Pindahkan direktori poll kedalam direktori django-polls.

    3. \n

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

    \n
    django-polls/README.rst
    \n
    Rst
    =====\nPolls\n=====\n\nPolls is a simple 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        'polls',\n    ]\n\n2. Include the polls URLconf in your project urls.py like this::\n\n    path('polls/', include('polls.urls')),\n\n3. Run `python manage.py migrate` to create the polls models.\n\n4. Start the development server and visit http://127.0.0.1:8000/admin/\n   to create a poll (you'll need the Admin app enabled).\n\n5. Visit http://127.0.0.1:8000/polls/ to participate in the poll.\n
    \n
    4. \n

  4. 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.

    5. \n

  5. Next we'll create setup.cfg and setup.py files which detail how to\nbuild and install the app. A full explanation of these files is beyond the\nscope of this tutorial, but the setuptools documentation has a good explanation.\nCreate the files django-polls/setup.cfg and django-polls/setup.py\nwith the following contents:

    \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.6\n    Programming Language :: Python :: 3.7\n    Programming Language :: Python :: 3.8\n    Topic :: Internet :: WWW/HTTP\n    Topic :: Internet :: WWW/HTTP :: Dynamic Content\n\n[options]\ninclude_package_data = true\npackages = find:\n
    \n
    django-polls/setup.py
    \n
    Python
     from setuptools import setup\n\n setup()\n
    \n
    6. \n

  6. Hanya modul dan paket Phyton yang disertakan dalam paket secara awal. Untuk menyertakan berkas tambahan, kami akan butuh membuat berkas MANIFEST.in. Dokumentasi alat pengaturan mengacu di langkah sebelumnya obrolkan berkas ini lebih rinci. Untuk menyertakan cetakan, berkas README.rst dan LICENSE kami, membuat sebuah berkas django-polls/MANIFEST.in dengan isi berikut:

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

  7. Ini adalah pilihan, tetapi disarankan, untuk menyertakan dokumentasi rinci dengan aplikasi anda. Buat direktori kosong django-polls/docs untuk dokumentasi akan datang. Tambah sebuah tambahan baris pada django-polls/MANIFEST.in:

    \n
    Code
    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
    8. \n

  8. Coba membangun paket anda dengan python setup.py sdist (jalankan dari dalam django-polls). Ini membuat direktori dipanggil dist dan bangun paket baru anda, django-polls-0.1.tar.gz.

    9. \n
\n

For more information on packaging, see Python's Tutorial on Packaging and\nDistributing Projects.

\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. Untuk memasang paket, gunakan pip (anda sudah memasangnya, benar?):

    \n
    Code
    pip install --user django-polls/dist/django-polls-0.1.tar.gz\n
    \n
    2. \n

  2. Dengan keberuntungan, proyek Django anda seharusnya sekarang bekerja dengan benar kembali. Jalankan peladen kembali untuk menegaskan ini.

    3. \n

  3. Untuk melepas paket. gunakan pip:

    \n
    Code
    pip uninstall django-polls\n
    \n
    4. \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

Memasang paket Phyton dengan virtualenvLink to this heading#

\n

Sebelumnya, kami memasalang aplikasi poling sebagai pustaka pengguna. Ini mempunyai beberapa kerugian:

\n\n

Khususnya, keadaan ini hanya muncul sekali anda sedang merawat beberapa proyek Django. Ketike mereka melakukan, pemecahan terbaik adalah menggunakan virtualenv. Alat ini mengizinkan anda untuk merawat banyak lingkungan Python terpencil, masing-masing dengan salinan itu 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":"Memasang paket Phyton dengan virtualenv","anchor":"installing-python-packages-with-virtualenv","children":[]}],"breadcrumbs":[{"docname":"intro/index","title":"Mulai","url":"/id/2.2/intro/"}],"prev":{"docname":"intro/tutorial07","title":"Menulis aplikasi Django kedua anda, bagian 7","url":"/id/2.2/intro/tutorial07/"},"next":{"docname":"intro/whatsnext","title":"Apa yang akan dibaca selanjutnya","url":"/id/2.2/intro/whatsnext/"},"formats":{"html":"/id/2.2/intro/reusable-apps/","markdown":"/id/2.2/intro/reusable-apps.md","json":"/id/2.2/intro/reusable-apps.json"},"source":"https://github.com/django/django/blob/stable/2.2.x/docs/intro/reusable-apps.txt","official":"https://docs.djangoproject.com/id/2.2/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","pt-br","ko","es","el","pl"]}