Lynx 
Are you bored of connect your device to your computer to know what's happening inside your app? If you hate it, this is going to be your favorite library. Shake your phone, press a button or add a LynxView to your layouts and you'll see what Andoird logcat is printing :)
Lynx is an Android library created to show a custom view with all the information logcat is printing, different traces of different levels will be rendererd to show from log messages to your application exceptions. You can filter this traces (using regular expressions if you want), share your logcat to other apps, configure the max number of traces to show or the sampling rate used by the library. The min Api Level supported is 10.
Screenshots
Usage
To use Lynx Android library and get your logcat inside your app you can use different approaches:
-
- Start
LynxActivityusing aLynxConfigobject.
- Start
private void openLynxActivity() {
LynxConfig lynxConfig = new LynxConfig();
lynxConfig.setMaxNumberOfTracesToShow(4000)
.setFilter("WTF");
Intent lynxActivityIntent = LynxActivity.getIntent(this, lynxConfig);
startActivity(lynxActivityIntent);
}
-
- Configure
LynxShakeDetectorto startLynxActivityif you shake your phone.
- Configure
public class YourApplication extends Application {
@Override public void onCreate() {
super.onCreate();
LynxShakeDetector lynxShakeDetector = new LynxShakeDetector(this);
lynxShakeDetector.init();
}
}
-
- Add
LynxViewto your layouts and configure it as you wish.
- Add
<com.github.pedrovgs.lynx.LynxView
xmlns:lynx="http://schemas.android.com/apk/res-auto"
android:layout_width="match_parent"
android:layout_height="@dimen/lynx_view_height"
lynx:filter="Lynx"
lynx:max_traces_to_show="1500"
lynx:text_size="12sp"/>
You can provide different configurations based on styleable attributes:
- Filter to apply by default:
lynx:filter="Lynx" - Max number of traces to show inside LynxView:
lynx:max_traces_to_show=3000 - Text size used to render traces inside LynxView:
lynx:text_size="12sp - Sampling rate used to read from the application log:
lynx:sampling_rate=200
To be able to show LynxActivity shaking your phone or starting it programatically you'll have to add LynxActivity to your AndroidManifest.
<activity android:name="com.github.pedrovgs.lynx.LynxActivity"/>
If you have to support applications based on Android 2.X you'll have to add READ_LOG permission to your AndroidManifest. This is not needed for newer Android versions.
<uses-permission android:name="android.permission.READ_LOGS"/>
Add it to your project
Add Lynx dependency to your build.gradle
dependencies{
compile 'com.github.pedrovgs:lynx:1.1.0'
}
Or add Lynx as a new dependency inside your pom.xml
<dependency>
<groupId>com.github.pedrovgs</groupId>
<artifactId>lynx</artifactId>
<version>1.0.7</version>
<type>aar</type>
</dependency>
Do you want to contribute?
I'd like to improve this library with your help, there are some new features to implement waiting for you ;)
- Play/Pause LynxView.
- Provide a custom UI based on styles.
- Any cool feature you can imagine!
Libraries used in this project
Developed By
- Pedro Vicente Gómez Sánchez - [email protected]
License
Copyright 2015 Pedro Vicente Gómez Sánchez
Licensed under the Apache License, Version 2.0 (the "License");
you may not use this file except in compliance with the License.
You may obtain a copy of the License at
http://www.apache.org/licenses/LICENSE-2.0
Unless required by applicable law or agreed to in writing, software
distributed under the License is distributed on an "AS IS" BASIS,
WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
See the License for the specific language governing permissions and
limitations under the License.
128 Nov 25, 2022
668 Dec 15, 2022
3 Dec 2, 2022
407 Jan 9, 2023
4 Mar 8, 2022
28 Oct 7, 2022
32 Dec 11, 2021
2.8k Jan 9, 2023
8.1k Dec 29, 2022
151 Nov 25, 2022
17 Feb 4, 2022
3 May 8, 2022
12.6k Jan 7, 2023
938 Dec 20, 2022
148 Nov 14, 2022
4 Sep 29, 2022
131 Jan 9, 2023
1.1k Jan 2, 2023