Skip to content
This repository was archived by the owner on Nov 22, 2024. It is now read-only.

Commit fbbf8cf

Browse files
danielbuecheleSebastian McKenziejknoxvilleEmil Sjölanderpriteshrnandgaonkar
committed
Initial commit 🎉
fbshipit-source-id: b6fc29740c6875d2e78953b8a7123890a67930f2 Co-authored-by: Sebastian McKenzie <[email protected]> Co-authored-by: John Knox <[email protected]> Co-authored-by: Emil Sjölander <[email protected]> Co-authored-by: Pritesh Nandgaonkar <[email protected]>
0 parents  commit fbbf8cf

File tree

659 files changed

+87130
-0
lines changed

Some content is hidden

Large Commits have some content hidden by default. Use the searchbox below for content that may be hidden.

659 files changed

+87130
-0
lines changed

‎.eslintignore

+8
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,8 @@
1+
src/fb/plugins/relaydevtools/relay-devtools/*
2+
latest
3+
resources
4+
templates
5+
node_modules
6+
flow-typed
7+
lib
8+
!.eslintrc.js

‎.eslintrc.js

+30
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,30 @@
1+
/**
2+
* Copyright 2018-present Facebook.
3+
* This source code is licensed under the MIT license found in the
4+
* LICENSE file in the root directory of this source tree.
5+
* @format
6+
*/
7+
8+
const fbjs = require('eslint-config-fbjs');
9+
10+
// enforces copyright header and @format directive to be present in every file
11+
const pattern = /^\*\n \* Copyright 2018-present Facebook\.\n \* This source code is licensed under the MIT license found in the\n \* LICENSE file in the root directory of this source tree\.\n \* @format\n./;
12+
13+
module.exports = {
14+
extends: 'fbjs',
15+
plugins: [...fbjs.plugins, 'header', 'prettier'],
16+
rules: {
17+
// disable rules from eslint-config-fbjs
18+
'react/react-in-jsx-scope': 0, // not needed with our metro implementation
19+
'no-new': 0, // new keyword needed e.g. new Notification
20+
'no-catch-shadow': 0, // only relevant for IE8 and below
21+
'no-bitwise': 0, // bitwise operations needed in some places
22+
'consistent-return': 0,
23+
'max-len': 0, // let's take prettier take care of this
24+
indent: 0, // let's take prettier take care of this
25+
26+
// additional rules for this project
27+
'header/header': [2, 'block', {pattern}],
28+
'prettier/prettier': [2, 'fb', '@format'],
29+
},
30+
};

‎.flowconfig

+24
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,24 @@
1+
[ignore]
2+
.*/scripts/.*
3+
.*/coverage/.*
4+
.*/node_modules/.*
5+
.*/build/.*
6+
.*/dist/.*
7+
.*/static/.*
8+
<PROJECT_ROOT>/src/fb/plugins/relaydevtools/relay-devtools/DevtoolsUI.js$
9+
.*/website/.*
10+
11+
[libs]
12+
lib
13+
flow-typed
14+
15+
[options]
16+
esproposal.export_star_as=enable
17+
module.use_strict=true
18+
emoji=true
19+
all=true
20+
include_warnings=true
21+
module.name_mapper='sonar' -> '<PROJECT_ROOT>/src/index.js'
22+
23+
[version]
24+
0.69.0

‎.gitignore

+6
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,6 @@
1+
node_modules
2+
dist
3+
website/build
4+
*.xcworkspace
5+
**/Pods/
6+
**/xcuserdata/

‎.gitmodules

+3
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,3 @@
1+
[submodule "libs/folly"]
2+
path = libs/folly
3+
url = https://github.com/facebook/folly.git

‎.sonarhandles

+1
Original file line numberDiff line numberDiff line change
@@ -0,0 +1 @@
1+
{"osx": "GICWmAAS05ZnyDsCAAAAAABHIak5bnw7AAAg", "linux": "GICWmACHSiVuyDsCAAAAAABVAX1Bbnw7AAAg", "windows": "GICWmAAn5YB0yDsCAAAAAAAMdghhbnw7AAAg"}

‎.travis.yml

+56
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,56 @@
1+
os: osx
2+
osx_image: xcode9.3
3+
4+
matrix:
5+
include:
6+
- language: node_js
7+
node_js:
8+
- "8"
9+
10+
install:
11+
- yarn
12+
- cd website
13+
- yarn
14+
- cd ..
15+
16+
script:
17+
- yarn lint
18+
- yarn build macOnly build-number=$TRAVIS_BUILD_NUMBER
19+
- cd website
20+
- yarn build
21+
- cd ..
22+
23+
before_deploy:
24+
- export SONAR_VERSION="v$(plutil -p $TRAVIS_BUILD_DIR/dist/mac/Sonar.app/Contents/Info.plist | awk '/CFBundleShortVersionString/ {print substr($3, 2, length($3)-2)}')"
25+
26+
deploy:
27+
- provider: pages
28+
skip-cleanup: true
29+
github-token: $GITHUB_TOKEN
30+
fqdn: fbsonar.com
31+
local-dir: website/build/sonar
32+
keep-history: true
33+
on:
34+
branch: master
35+
- provider: releases
36+
api_key: $GITHUB_TOKEN
37+
file: dist/Sonar.zip
38+
name: $SONAR_VERSION
39+
draft: true
40+
skip_cleanup: true
41+
on:
42+
branch: master
43+
44+
- language: objective-c
45+
46+
before_install:
47+
- pod repo update
48+
49+
install:
50+
- cd iOS/Sample
51+
- pod install
52+
- cd ../../
53+
54+
script:
55+
- cd iOS/Sample
56+
- xcodebuild clean build -workspace Sample.xcworkspace -scheme Pods-Sample

‎.vscode/launch.json

+12
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,12 @@
1+
{
2+
"version": "0.2.0",
3+
"configurations": [
4+
{
5+
"name": "Attach to Running Renderer",
6+
"type": "chrome",
7+
"request": "attach",
8+
"port": 9222,
9+
"webRoot": "${workspaceRoot}"
10+
}
11+
]
12+
}

‎.yarnrc

+1
Original file line numberDiff line numberDiff line change
@@ -0,0 +1 @@
1+
--install.mutex network

‎CODE_OF_CONDUCT.md

+3
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,3 @@
1+
# Code of Conduct
2+
3+
Facebook has adopted a Code of Conduct that we expect project participants to adhere to. Please [read the full text](https://code.facebook.com/codeofconduct) so that you can understand what actions will and will not be tolerated.

‎CONTRIBUTING.md

+55
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,55 @@
1+
# Contributing to Sonar
2+
3+
We want to make contributing to this project as easy and transparent as
4+
possible.
5+
6+
## Our Development Process
7+
8+
Changes from Facebook employees are synced to the GitHub repo automatically.
9+
PRs from the community are imported into our internal source control and then
10+
pushed to GitHub.
11+
12+
For changes affecting both, native code and JavaScript, make sure to only create
13+
a single PR containing both parts of the code.
14+
15+
Although the Sonar desktop app is only released for macOS right now, it is
16+
possible to create Windows and Linux builds of the app. Please keep this in mind
17+
when dealing with platform-specific code.
18+
19+
## Pull Requests
20+
21+
We actively welcome your pull requests.
22+
23+
1. Fork the repo and create your branch from `master`.
24+
2. If you've added code that should be tested, add tests.
25+
3. If you've changed APIs, update the documentation.
26+
4. Ensure the test suite passes.
27+
5. Make sure your code lints.
28+
6. If you haven't already, complete the Contributor License Agreement ("CLA").
29+
30+
## Contributor License Agreement ("CLA")
31+
32+
In order to accept your pull request, we need you to submit a CLA. You only need
33+
to do this once to work on any of Facebook's open source projects.
34+
35+
Complete your CLA here: <https://code.facebook.com/cla>
36+
37+
## Issues
38+
39+
We use GitHub issues to track public bugs. Please ensure your description is
40+
clear and has sufficient instructions to be able to reproduce the issue.
41+
42+
Facebook has a [bounty program](https://www.facebook.com/whitehat/) for the safe
43+
disclosure of security bugs. In those cases, please go through the process
44+
outlined on that page and do not file a public issue.
45+
46+
## Coding Style
47+
48+
We are using Prettier to format our source code. The styles are enforced via
49+
eslint. Make sure everything is well formatted before creating a PR. Therefore,
50+
run `yarn lint` and `yarn fix` to apply formatting fixes.
51+
52+
## License
53+
54+
By contributing to Sonar, you agree that your contributions will be licensed
55+
under the LICENSE file in the root directory of this source tree.

‎LICENSE

+21
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,21 @@
1+
MIT License
2+
3+
Copyright (c) 2004-present, Facebook, Inc.
4+
5+
Permission is hereby granted, free of charge, to any person obtaining a copy
6+
of this software and associated documentation files (the "Software"), to deal
7+
in the Software without restriction, including without limitation the rights
8+
to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
9+
copies of the Software, and to permit persons to whom the Software is
10+
furnished to do so, subject to the following conditions:
11+
12+
The above copyright notice and this permission notice shall be included in all
13+
copies or substantial portions of the Software.
14+
15+
THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
16+
IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
17+
FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
18+
AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
19+
LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
20+
OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
21+
SOFTWARE.

‎README.md

+54
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,54 @@
1+
Sonar is a desktop app and client API for real time debugging of mobile apps. Sonar enables developers to quickly build plugins which expose runtime information from Android and iOS apps in a easy to use desktop interface.
2+
3+
# Why should I build tools on top of Sonar?
4+
5+
Sonar provides you with everything you need to quickly get your tools into people hands. Sonar provides a simple API for communicating with both Android and iOS devices, reconnecting if connection is lost as well as managing multiple connections. With Sonar's built in set of components it is easy to make good looking, easy to use, and powerful developer tools.
6+
7+
# In this repo
8+
9+
This repository includes all parts of Sonar. This includes:
10+
11+
* Sonar's desktop app built using Electron (`/src`)
12+
* native Sonar SDKs for iOS
13+
* native Sonar SDKs for Android
14+
* Plugins:
15+
* Logs (`/src/device-plugins/logs`)
16+
* Layout inspector (`/src/plugins/layout`)
17+
* Network inspector (`/src/plugins/network`)
18+
* website and documentation (`/website` / `/docs`)
19+
20+
# Getting started
21+
22+
## Requirements
23+
24+
* macOS (while Sonar is buildable using other systems as well, only macOS is officially supported)
25+
* node >= 8
26+
* yarn >= 1.5
27+
* iOS developer tools (for developing iOS plugins)
28+
* Android SDK and adb
29+
30+
## Starting the desktop app
31+
32+
```
33+
git clone https://github.com/facebook/Sonar.git
34+
cd Sonar
35+
yarn
36+
yarn start
37+
```
38+
39+
## Building the desktop app
40+
41+
```
42+
yarn build [macOnly] [build-number=$buildNumber]
43+
```
44+
45+
A binary for macOS is created in `dist/mac`. `macOnly` and `build-number` are optional params.
46+
47+
## Documentation
48+
49+
Find the full documentation for this project at [fbsonar.com](https://fbsonar.com/).
50+
51+
## Contributing and license
52+
53+
See the CONTRIBUTING file for how to help out.
54+
Sonar is MIT licensed, as found in the LICENSE file.

‎android/AndroidManifest.xml

+4
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,4 @@
1+
<?xml version="1.0" encoding="utf-8"?>
2+
<manifest xmlns:android="http://schemas.android.com/apk/res/android"
3+
package="com.facebook.sonar">
4+
</manifest>

‎android/CMakeLists.txt

+63
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,63 @@
1+
cmake_minimum_required (VERSION 3.6.0)
2+
project(sonar CXX C)
3+
set(CMAKE_VERBOSE_MAKEFILE on)
4+
5+
set(PACKAGE_NAME "sonar")
6+
7+
add_compile_options(-DFOLLY_NO_CONFIG
8+
-DSONAR_JNI_EXTERNAL=1
9+
-DFB_SONARKIT_ENABLED=1
10+
-DFOLLY_HAVE_MEMRCHR
11+
-DFOLLY_MOBILE=1
12+
-DFOLLY_USE_LIBCPP=1
13+
-DFOLLY_HAVE_LIBJEMALLOC=0
14+
-DFOLLY_HAVE_PREADV=0
15+
-frtti
16+
-fexceptions
17+
-std=c++14
18+
-Wno-error
19+
-Wno-unused-local-typedefs
20+
-Wno-unused-variable
21+
-Wno-sign-compare
22+
-Wno-comment
23+
-Wno-return-type
24+
-Wno-tautological-constant-compare
25+
)
26+
27+
file(GLOB SOURCES android/sonar.cpp)
28+
add_library(${PACKAGE_NAME} SHARED ${SOURCES})
29+
target_include_directories(${PACKAGE_NAME} PUBLIC "./")
30+
31+
set(libjnihack_DIR ${CMAKE_SOURCE_DIR}/../libs/jni-hack/)
32+
set(libfbjni_DIR ${CMAKE_SOURCE_DIR}/../libs/fbjni/src/main/cpp/include/)
33+
set(libsonar_DIR ${CMAKE_SOURCE_DIR}/../xplat/)
34+
set(third_party_ndk build/third-party-ndk)
35+
set(libfolly_DIR ${third_party_ndk}/folly/)
36+
set(glog_DIR ${third_party_ndk}/glog)
37+
set(BOOST_DIR ${third_party_ndk}/boost/boost_1_63_0/)
38+
39+
40+
set(build_DIR ${CMAKE_SOURCE_DIR}/build)
41+
42+
set(fbjni_build_DIR ${build_DIR}/fbjni/${ANDROID_ABI})
43+
set(libsonar_build_DIR ${build_DIR}/libsonar/${ANDROID_ABI})
44+
set(libfolly_build_DIR ${build_DIR}/libfolly/${ANDROID_ABI})
45+
46+
file(MAKE_DIRECTORY ${build_DIR})
47+
48+
add_subdirectory(${libsonar_DIR} ${libsonar_build_DIR})
49+
add_subdirectory(${libfbjni_DIR}/../ ${fbjni_build_DIR})
50+
51+
target_include_directories(${PACKAGE_NAME} PRIVATE
52+
${libjnihack_DIR}
53+
${libfbjni_DIR}
54+
${libsonar_DIR}
55+
${libfolly_DIR}
56+
${glog_DIR}
57+
${glog_DIR}/../
58+
${glog_DIR}/glog-0.3.5/src/
59+
${BOOST_DIR}
60+
${BOOST_DIR}/../
61+
)
62+
63+
target_link_libraries(${PACKAGE_NAME} fb sonarcpp)

0 commit comments

Comments
 (0)