https://github.com/duckduckgo/iOS

DuckDuckGo iOS Application
https://github.com/duckduckgo/iOS

duckduckgo privacy private-browsing private-search

Last synced: about 1 month ago
JSON representation

DuckDuckGo iOS Application

• Host: GitHub
• URL: https://github.com/duckduckgo/iOS
• Owner: duckduckgo
• License: apache-2.0
• Created: 2017-01-13T17:09:36.000Z (almost 8 years ago)
• Default Branch: main
• Last Pushed: 2024-10-29T09:00:14.000Z (about 2 months ago)
• Last Synced: 2024-10-29T09:52:29.004Z (about 1 month ago)
• Topics: duckduckgo, privacy, private-browsing, private-search
• Language: HTML
• Homepage: https://itunes.apple.com/us/app/duckduckgo-privacy-browser/id663592361?mt=8
• Size: 150 MB
• Stars: 1,830
• Watchers: 95
• Forks: 416
• Open Issues: 29
• Metadata Files:
  • Readme: README.md
  • Contributing: CONTRIBUTING.md
  • License: LICENSE.md

Awesome Lists containing this project

• awesome - iOS - DuckDuckGo iOS Application (private-search)
• awesome - iOS - DuckDuckGo iOS Application (duckduckgo)

README

        
# DuckDuckGo iOS

We are excited to engage the community in development!

## We are hiring!

DuckDuckGo is growing fast and we continue to expand our fully distributed team. We embrace diverse perspectives, and seek out passionate, self-motivated people, committed to our shared vision of raising the standard of trust online. If you are a senior software engineer capable in either iOS or Android, visit our [careers](https://duckduckgo.com/hiring/#open) page to find out more about our openings!

## Building

### Submodules

We use submodules, so you will need to bring them into the project in order to build and run it:

Run `git submodule update --init --recursive`

### Developer details

If you're not part of the DuckDuckGo team, you should provide your Apple developer account id, app id, and group id prefix in an `ExternalDeveloper.xcconfig` file. To do that:

 1. Run `cp Configuration/DuckDuckGoDeveloper.xcconfig Configuration/ExternalDeveloper.xcconfig`

 2. Edit `Configuration/ExternalDeveloper.xcconfig` and change the values of all fields

 3. Clean and rebuild the project

### Dependencies

We use Swift Package Manager for dependency management, which shouldn't require any additional set up.

### SwiftLint

We use [SwifLint](https://github.com/realm/SwiftLint) for enforcing Swift style and conventions, so you'll need to [install it](https://github.com/realm/SwiftLint#installation).

## Debugging

### Instruments

We have a Custom Instruments tool to help visualize and track events that happen during runtime.

In order to run it:

1. Build a debug version and install it on a simulator or device.

2. Select the Instruments target and run it on a Mac. A new instance of the Instruments app will run. It will have a grayed out icon indicating that it works in debug mode with custom instruments attached.

3. Select the 'DDG Trace' template or set up a custom one by importing the 'DDG Timeline' instrument from Library.

4. Start recording.

See [Instruments Developer Help](https://help.apple.com/instruments/developer/mac/current/) for reference how to create custom instruments.

## Terminology

We have taken steps to update our terminology and remove words with problematic racial connotations, most notably the change to `main` branches, `allow lists`, and `blocklists`. Closed issues or PRs may contain deprecated terminology that should not be used going forward.

## Contribute

Please refer to [contributing](CONTRIBUTING.md).

## Discuss

Contact us at https://duckduckgo.com/feedback if you have feedback, questions or want to chat. You can also use the feedback form embedded within our Mobile App - to do so please navigate to Settings and select "Send Feedback".

## License

DuckDuckGo is distributed under the Apache 2.0 [license](https://github.com/duckduckgo/ios/blob/master/LICENSE.md).