Yamyam: 1版をインポートしました

2018-06-28T21:05:14Z

1版をインポートしました

2018年5月24日 (木) 05:57にwiki>Ideasman42による

2018-05-24T05:57:26Z

新規ページ

=Addons=

Blender builds and releases include python script addons that extend its functionality. This page has information for developers who want to have their addon bundled with Blender.

{{NiceTip|Mandatory Prerequisite to get an Addon accepted|You must be aware that your Addon will be integrated into the official Blender distribution. Therefor you must ensure there is continuous support for keeping your Addon working and fixing bugs as they appear. So you must commit yourself (or find a maintainer who does it for you) to do the maintenance (see ''General Guidelines for Addon Developers'' below)}}

* [https://developer.blender.org/project/view/3/ Addons Project] on developer.blender.org
* [https://developer.blender.org/maniphest/task/edit/form/3/ Submit an Addon] on developer.blender.org

== Contact ==

* [http://lists.blender.org/mailman/listinfo/bf-python bf-python mailing list] for all python scripting and addon related questions
* #blenderpython IRC channel on irc.freenode.net

== Repositories ==

Addons are hosted in two Git repositories, that are automatically checked out as a submodule of the main Blender repository.

* [https://developer.blender.org/diffusion/BA/ Blender Addons]: included in official releases on blender.org, strictly reviewed
* [https://developer.blender.org/diffusion/BAC/ Blender Addons Contrib]: included in test builds in the Testing tab, for more adventurous users

They can be found in these two directories of the main Blender repository:
release/scripts/addons
release/scripts/addons_contrib

== Submitting an Addon ==

* Follow the [[Dev:2.5/Py/Scripts/Guidelines/Addons|Guidelines for Addons]] when implementing it.
* Ensure you have a page in the [[Extensions:2.6/Py/Scripts|Addons Catalog]].
* [https://developer.blender.org/maniphest/task/edit/form/3/ Submit the Addon] on developer.blender.org
* Try to get your addons tested by users, gather feedback and improve as needed.

The reviewer will decide if the addon can be included in official release, included in the Contrib repository or can't be included. If the addon is in the Contrib repository and matures, you can later mail [http://lists.blender.org/mailman/listinfo/bf-python bf-python] and ask for the Addon to be moved to the repository for official releases.

If the addon is on track to be included in official releases, you may be asked to submit it to our [[Dev:Doc/Tools/Code_Review|Code Review]] tool for a closer review.

== External "Commercial" Addons ==

Blender Foundation will accept add-ons from commercial vendors or services (like 3d printing, web publishing, renderfarms) under the following conditions:

# Compliancy <br />The add-on should comply to the same quality/design rules as we do for regular add-ons. That includes license compliancy, but also to not include banners, logos or advertisement.
# Clear user benefit <br />The add-on should provide functionality to 3D artists that's useful to have inside Blender. It can't be for promotional usage of non-functional features (like linking to websites only, for tutorials, etc).
# The add-on will by default not be enabled
# Developed and maintained well <br />The add-on is being created and maintained by the service provider (or a contracter managed by them).
# Development Fund support <br />The service provider signs up for Diamond Sponsor level (250 euro per month). Cancelling a payment then also means we can drop the add-on. Any service that's not making this profits per month with an add-on, can be considered to be not interested to have such an add-on either.

==General Guidelines for Addon Developers==

If you attempt to submit your Addon either to the contrib section or to the release section of the Addon Repository, then your addon will undergo a review process. Within this process changes may be requested to keep inline with good coding practices. Those changes may be provided by you or by the reviewer. This will be clarified with the reviewer on a case by case basis.

Once your addon is accepted and hosted in the Blender release section or the contrib section, you become responsible for maintaining your Addon and you get commit permissions to the Addon repository...

== Duties of an Addon maintainer ==

As soon as you got the commit permissions you...

====== Must Do ======

* Maintain and further improve your addon by yourself.
* Ensure your Addon keeps working with new Blender Releases and API changes. Therefor check regularly & keep up to date in between Blender Official release to ensure your addon is working in the next release of Blender.
* Handle bug reports from users.
* When you add new features then you also should add brief documentation and explanations to the Blender release notes.
* Check regularly for patches to your addon from other users and eventually commit updates they make using the current git version of the addon as the base.

{{NiceTip|Avoid unmaintained Addons|Addons that are not supported (or no longer supported) by their Authors may be removed from Blender if they are broken & we can not find a maintainer.}}

====== Should Do ======

* Join the [http://lists.blender.org/mailman/listinfo/bf-extensions-cvs bf-extensions-cvs] mailing list to see what's going on, and optionally the [http://lists.blender.org/mailman/listinfo/bf-python bf-python mailing list].
* Write good commit messages that explain which addon and what exactly you change ([http://markmail.org/message/flgr4pums6laqklv good example]).
* It's acceptable to test other developers’ addons, and commit small fixes to their code (like a typo or obvious bug fixes).
* Optional: make your script [http://www.python.org/dev/peps/pep-0008/ pep8 compliant] and follow [http://www.blender.org/documentation/blender_python_api_2_68a_release/info_best_practice.html best practice].

====== Never Do ======

* Commit code that is not GPL2+ or compatible with it.
* Commit code you are not the author of (unless you have the author’s authorization).
* Commit big changes to other addons (unless you get the author’s permission).
* Commit binary files like .exe, .pyc, .pyd, .dll, .whl, etc.
* Add commit logs in your code (Git logs should be enough)

==== Working with Git ====

The same advice from our [[Dev:Doc/Tools/Git|Git Usage]] page applies here.

If you have a full Blender checkout, you can go into the <tt>release/scripts/addons</tt> or <tt>release/scripts/addons_contrib</tt> directory, and it's as if you are working in the Blender Addons or Blender Addons Contrib repositories directly. You can do all the typical git commands there for adding files, committing changes, and fetching and rebasing updates.

Optionally you can choose to clone the individual repositories and work there:
<source lang="bash">
git clone git://git.blender.org/blender-addons.git
git clone git://git.blender.org/blender-addons-contrib.git
</source>

== Bug Reports ==

Bugs for all addons are reported to the Addons project on developer.blender.org. If a bug is filed for your addon, the bug will be assigned to you as the addon maintainer.

You can also help out with bugs that are marked as Needs Triage in the tracker, to assign them to the right maintainer, confirm the problem or even fix the bug yourself.

← 古い版	2018年6月28日 (木) 21:05時点における版
(相違点なし)

Dev:Doc/Process/Addons - 版の履歴

Yamyam: 1版 をインポートしました

2018年5月24日 (木) 05:57にwiki>Ideasman42による

Yamyam: 1版をインポートしました