Submitting an action requires advanced Swift knowledge. I don't have time for low-quality pull requests.
- Open an issue for discussion first.
- The action name must start with a verb.
- One action addition per pull request, unless they are connected.
- Please help review the other open pull requests and action proposals.
- Open the Xcode project.
- Decide whether the action should reside in the intents extension or the app. Prefer the intents extension. Generally, only actions requiring significant memory or ones that open the main app should be in the app target.
- Create a new file in the
Actions
folder (in the correct target) named after the intent you are creating.- The file should be alphabetically sorted in Xcode.
- Keep the naming, description, and code style consistent with existing actions.
- Implement the logic. Try to create reusable extensions whenever it makes sense.
- Run the “Actions” target, which will open the app and then open the Shortcuts app. You can then test out your work.
- Add the action to
readme.md
andapp-store-description.txt
.
- Make sure you test on both macOS and iOS before submitting a pull request.
- Make sure linting passes.
- Use tab-indentation.
- The pull request should be titled
Add `Get Foo` action
whereGet Foo
is the name of the action. - Include a
Fixes #12
notation in the pull request description referencing the related issue.