https://github.com/duckduckgo/iOS

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

duckduckgo hacktoberfest privacy private-browsing private-search

Last synced: 3 months 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 (over 7 years ago)
• Default Branch: main
• Last Pushed: 2024-03-12T22:39:07.000Z (3 months ago)
• Last Synced: 2024-03-12T22:53:35.895Z (3 months ago)
• Topics: duckduckgo, hacktoberfest, privacy, private-browsing, private-search
• Language: HTML
• Homepage: https://itunes.apple.com/us/app/duckduckgo-privacy-browser/id663592361?mt=8
• Size: 106 MB
• Stars: 1,739
• Watchers: 95
• Forks: 398
• Open Issues: 58
• Metadata Files:
  • Readme: README.md
  • Contributing: CONTRIBUTING.md
  • License: LICENSE.md

Lists

• my-awesome-starred - duckduckgo/iOS - DuckDuckGo iOS Application (HTML)
• awesome-stars - duckduckgo/iOS - DuckDuckGo iOS Application (HTML)

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 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 Simulator/Device.

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

3. Select 'DDG Trace' template or set up a custom one by importing '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).