Frameworks/CreationGuidelines: Difference between revisions
No edit summary |
(Remove outdated items) |
||
(One intermediate revision by one other user not shown) | |||
Line 8: | Line 8: | ||
* Ensure the module doesn't depend on deprecated or "portingAid" frameworks like kdelibs4support | * Ensure the module doesn't depend on deprecated or "portingAid" frameworks like kdelibs4support | ||
* Ensure the module is in frameworks on projects.kde.org (the source information is in the repo kde:sysadmin/repo-metadata), otherwise ask for it to be moved there (https://go.kde.org/systickets) | * Ensure the module is in frameworks on projects.kde.org (the source information is in the repo kde:sysadmin/repo-metadata), otherwise ask for it to be moved there (https://go.kde.org/systickets) | ||
* | * Make sure it has Gitlab CI set up | ||
* Add a new product for it on bugs.kde.org, which must be called frameworks-<name> | * Add a new product for it on bugs.kde.org, which must be called frameworks-<name> | ||
* Create a README.md file | * Create a README.md file |
Latest revision as of 13:33, 19 May 2023
Guidelines for creating a new framework
If you are creating a new framework, this checklist can help you get it done correctly:
- Make sure it follows all the active policies
- The above includes many important things, make sure to read all of it. E.g. it includes the often forgotten rule for installing translations
- If it is created by splitting code from an existing repository, the new repository should be created by using a script to create a graft point
- Run astyle-kdelibs or uncrustify-kf5 (both are part of kde-dev-scripts)
- Ensure the module doesn't depend on deprecated or "portingAid" frameworks like kdelibs4support
- Ensure the module is in frameworks on projects.kde.org (the source information is in the repo kde:sysadmin/repo-metadata), otherwise ask for it to be moved there (https://go.kde.org/systickets)
- Make sure it has Gitlab CI set up
- Add a new product for it on bugs.kde.org, which must be called frameworks-<name>
- Create a README.md file
- Finally when it's all ready, change the yaml file to say release: true. The release scripts will then pick it up automatically for the next KF release.
Template
The framework-template directory in the kdeexamples repository has a setup.sh script that generates a helpful skeleton framework that is a good starting point for creating a framework. For example, if you were creating the KConfig framework, you might run
./setup.sh KConfig ../../kconfig
then go to the newly created "kconfig" directory and start adding source files etc.