这个进阶教程从 教程第 8 部分 结束的地方继续讲起。我们将会把我们的网络投票应用放进一个独立的 Python 包中，以便你在新的项目中重用它或将它与他人分享。
\n如果你最近没有完成教程 1-8，我们鼓励你回顾这些内容，以便你的示例项目与下面描述的项目相匹配。
\n设计，构建，测试以及维护一个 web 应用要做很多的工作。很多 Python 以及 Django 项目都有一些常见问题。如果我们能保存并利用这些重复的工作岂不是更好？
\n可重用性是 Python 的根本。The Python Package Index (PyPI) 有许大量的包，都可被用在你自己的 Python 项目中。同样可以在 Django Packages 中查找已发布的可重用应用，也可将其引入到你的项目中。Django 本身也是一个 Python 包，也就是说你可以将已有的 Python 包或 Django 应用并入你的项目。你只需要编写属于你的那部分即可。
\n假设你现在创建了一个新的项目，并且需要一个类似我们之前做的投票应用。你该如何复用这个应用呢？庆幸的是，其实你已经知道了一些。在 教程 1，我们使用过 include 从项目级别的 URLconf 分割出 polls。在本教程中，我们将进一步使这个应用易用于新的项目中，并发布给其他人安装使用。
通过前面的教程，我们的工程应该看起来像这样:
\ndjangotutorial/\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你在 教程 7 中创建了 djangotutorial/templates，在 教程 3 中创建了 polls/templates。现在可能更清楚为什么我们选择为项目和应用程序分别设置独立的模板目录了：所有属于 polls 应用程序的内容都放在 polls 中。这使得应用程序自包含，并且更容易移植到新项目中。
目录 polls 现在可以被拷贝至一个新的 Django 工程，且立刻被复用。不过现在还不是发布它的时候。为了这样做，我们需要打包这个应用，便于其他人安装它。
Python 包装的当前状态有些混乱，有各种各样的工具。对于本教程，我们将使用 setuptools 来构建我们的包。它是推荐的打包工具（与 distribute 分支合并）。我们还将使用 pip 来安装和卸载它。你现在应该安装这两个包。如果你需要帮助，可以参考 如何使用 pip 安装 Django。你可以以相同的方式安装 setuptools。
Python 的 打包 将以一种特殊的格式组织你的应用，意在方便安装和使用这个应用。Django 本身就被打包成类似的形式。对于一个小应用，例如 polls，这不会太难。
\n首先，在 Django 项目之外创建一个父目录来存放包。将该目录命名为 django-polls。
将 polls 目录移动到 django-polls 目录中，并将其重命名为 django_polls。
编辑 django_polls/apps.py，使 name 指向新的模块名称，并添加 label 以为应用程序提供一个简短的名称：
django-polls/django_polls/apps.pyfrom 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创建一个名为 django-polls/README.rst 的文件，包含以下内容：
django-polls/README.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创建一个 django-polls/LICENSE 文件。选择一个非本教程使用的授权协议，但是要足以说明发布代码没有授权证书是 不可能的 。Django 和很多兼容 Django 的应用是以 BSD 授权协议发布的；不过，你可以自己选择一个授权协议。只要确定你选择的协议能够限制未来会使用你的代码的人。
接下来我们将创建 pyproject.toml 文件，该文件详细说明了如何构建和安装应用程序。对这个文件的完整解释超出了本教程的范围，但 Python 打包用户指南 提供了很好的解释。创建 django-polls/pyproject.toml 文件，内容如下：
django-polls/pyproject.toml[build-system]\nrequires = ["setuptools>83"]\nbuild-backend = "setuptools.build_meta"\n\n[project]\nname = "django-polls"\nversion = "0.1"\ndependencies = [\n "django>=X.Y", # Replace "X.Y" as appropriate\n]\ndescription = "A Django app to conduct web-based polls."\nreadme = "README.rst"\nlicense = "BSD-3-Clause"\nrequires-python = ">= 3.10"\nauthors = [\n {name = "Your Name", email = "yourname@example.com"},\n]\nclassifiers = [\n "Environment :: Web Environment",\n "Framework :: Django",\n "Framework :: Django :: X.Y", # Replace "X.Y" as appropriate\n "Intended Audience :: Developers",\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 "Programming Language :: Python :: 3.13",\n "Programming Language :: Python :: 3.14",\n "Topic :: Internet :: WWW/HTTP",\n "Topic :: Internet :: WWW/HTTP :: Dynamic Content",\n]\n\n[project.urls]\nHomepage = "https://www.example.com/"\n默认情况下，许多常见文件和 Python 模块及包已经包含在包中。要包含额外的文件，我们需要创建一个 MANIFEST.in 文件。为了包含模板和静态文件，创建一个文件 django-polls/MANIFEST.in，内容如下：
django-polls/MANIFEST.inrecursive-include django_polls/static *\nrecursive-include django_polls/templates *\n虽然不是必须的，但建议为你的应用程序包含详细的文档。创建一个空目录 django-polls/docs 以便将来存放文档。
注意，现在 docs 目录不会被加入你的应用包，除非你往这个目录加几个文件。许多 Django 应用也提供他们的在线文档通过类似 readthedocs.org 这样的网站。
Many Python projects, including Django and Python itself, use Sphinx to build\ntheir documentation. If you choose to use Sphinx you can link back to the\nDjango documentation by configuring Intersphinx\nand including a value for Django in your project's intersphinx_mapping\nvalue:
intersphinx_mapping = {\n # ...\n "django": (\n "https://docs.djangoproject.com/en/stable/",\n None,\n ),\n}\nWith that in place, you can then cross-link to specific entries, in the\nsame way as in the Django docs, such as\n":attr:`django.test.TransactionTestCase.databases`".
Check that the build package is installed (python -m pip install\nbuild) and try building your package by running python -m build inside\ndjango-polls. This creates a directory called dist and builds your\nnew package into source and binary formats, django_polls-0.1.tar.gz and\ndjango_polls-0.1-py3-none-any.whl.
更多关于打包的信息，见 Python 的 关于打包和发布项目的教程。
\n由于我们把 polls 目录移出了项目，所以它无法工作了。我们现在要通过安装我们的新 django-polls 应用来修复这个问题。
为了安装这个包，使用 pip (你早已 安装 pip, 对吗？):
\npython -m pip install --user django-polls/dist/django_polls-0.1.tar.gz\n更新 mysite/settings.py 以指向新的模块名称：
INSTALLED_APPS = [\n "django_polls.apps.PollsConfig",\n ...,\n]\n更新 mysite/urls.py 以指向新的模块名称：
urlpatterns = [\n path("polls/", include("django_polls.urls")),\n ...,\n]\n运行开发服务器以确认项目继续工作。
现在，你已经对 django-polls 完成了打包和测试，准备好向世界分享它！如果这不是一个例子应用，你现在就可以这样做。
通过邮件将你的包发送给朋友。
将这个包上传至你的网站。
将你的包发布至公共仓库，比如 the Python Package Index (PyPI)。 packaging.python.org 有一个不错的 教程 说明如何发布至公共仓库。
早些时候，我们将 django-polls 安装为用户库。这样做有一些不利之处：
修改用户库会影响你系统上的其他 Python 软件。
你将不能运行此包的多个版本（或者其它用有相同包名的包）。
通常，只有在维护多个 Django 项目时才会出现这些情况。当这样做时，最好的解决方法是使用 venv。使用此工具，你可以维护多个隔离的 Python 环境，每个环境都有其自己的库和包命名空间的副本。
\n