< FrameworksRevision as of 22:14, 2 December 2019 by Dfaure (talk | contribs) (fix CI URL)(diff) ← Older revision | Latest revision (diff) | Newer revision → (diff) 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) Adjust kde:kde-build-metadata - in particular, add it to the deps for frameworks/kf5umbrella Get the CI jobs set up Get the job set up on build.kde.org by filing a task towards https://phabricator.kde.org/tag/build.kde.org/ Make sure to request it to be added to the relevant view: https://build.kde.org/job/Frameworks/ Ensure it is green 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. Retrieved from "https://community.kde.org/index.php?title=Frameworks/CreationGuidelines&oldid=86845" This page was last edited on 2 December 2019, at 22:14. Content is available under Creative Commons License SA 4.0 unless otherwise noted.