Git Product home page Git Product logo

gdperformanceview-swift's Introduction

GDPerformanceView-Swift

Shows FPS, CPU and memory usage, device model, app and iOS versions above the status bar and report FPS, CPU and memory usage via delegate.

Carthage compatible Pod Version Swift Version Swift Version Swift Version Plaform License MIT

Alt text Alt text Alt text Alt text

Installation

Simply add GDPerformanceMonitoring folder with files to your project, or use CocoaPods.

Carthage

Create a Cartfile that lists the framework and run carthage update. Follow the instructions to add $(SRCROOT)/Carthage/Build/iOS/GDPerformanceView.framework to an iOS project.

github "dani-gavrilov/GDPerformanceView-Swift" ~> 2.1.1

Don't forget to import GDPerformanceView by adding:

import GDPerformanceView

CocoaPods

You can use CocoaPods to install GDPerformanceView by adding it to your Podfile:

platform :ios, '8.0'
use_frameworks!

target 'project_name' do
	pod 'GDPerformanceView-Swift', '~> 2.1.1'
end

Don't forget to import GDPerformanceView by adding:

import GDPerformanceView_Swift

Usage example

Simply start monitoring. Performance view will be added above the status bar automatically. Also, you can configure appearance as you like or just hide the monitoring view and use its delegate.

You can find example projects here.

Start monitoring

By default, monitoring is paused. Call the following command to start or resume monitoring:

PerformanceMonitor.shared().start()

or

self.performanceView = PerformanceMonitor()
self.performanceView?. start()

This won't show the monitoring view if it was hidden previously. To show it call the following command:

self.performanceView?.show()

Pause monitoring

Call the following command to pause monitoring:

self.performanceView?.pause()

This won't hide the monitoring view. To hide it call the following command:

self.performanceView?.hide()

Displayed information

You can change displayed information by changing options of the performance monitor:

self.performanceView?.performanceViewConfigurator.options = .all

You can choose from:

  • performance - CPU usage and FPS.
  • memory - Memory usage.
  • application - Application version with build number.
  • device - Device model.
  • system - System name with version.

Also you can mix them, but order doesn't matter:

self.performanceView?.performanceViewConfigurator.options = [.performance, .application, .system]

By default, set of [.performance, .application, .system] options is used.

You can also add your custom information by using:

self.performanceView?.performanceViewConfigurator.userInfo = .custom(string: "Launch date \(Date())")

Keep in mind that custom string will not automatically fit the screen, use \n if it is too long.

Appearance

You can change monitoring view appearance by changing style of the performance monitor:

Call the following command to change output information:

self.performanceView?.performanceViewConfigurator.style = .dark

You can choose from:

  • dark - Black background, white text.
  • light - White background, black text.
  • custom - You can set background color, border color, border width, corner radius, text color and font.

By default, dark style is used.

Also you can override prefersStatusBarHidden and preferredStatusBarStyle to match your expectations:

self.performanceView?.statusBarConfigurator.statusBarHidden = false
self.performanceView?.statusBarConfigurator.statusBarStyle = .lightContent

Interactions

You can interact with performance view via gesture recognizers. Add them by using:

self.performanceView?.performanceViewConfigurator.interactors = [tapGesture, swipeGesture]

If interactors is nil or empty point(inside:with:) of the view will return false to make all touches pass underneath. So to remove interactors just call the following command:

self.performanceView?.performanceViewConfigurator.interactors = nil

By default, interactors are nil.

Delegate

Set the delegate and implement its method:

self.performanceView?.delegate = self
func performanceMonitor(didReport performanceReport: PerformanceReport) {
	print(performanceReport.cpuUsage, performanceReport.fps, performanceReport.memoryUsage.used, performanceReport.memoryUsage.total)
}

Requirements

  • iOS 9.0+
  • xCode 12.0+

Donations

Wanna say thanks? You can do it using Patreon.

Meta

Daniil Gavrilov - VK - FB

I will be pleased to know that your project uses this framework. You can send a link to your project in App Store to my email - [email protected].

License

GDPerformanceView is available under the MIT license. See the LICENSE file for more info.

gdperformanceview-swift's People

Contributors

dani-gavrilov avatar basthomas avatar tinora avatar jinjiegu avatar

Recommend Projects

  • React photo React

    A declarative, efficient, and flexible JavaScript library for building user interfaces.

  • Vue.js photo Vue.js

    ๐Ÿ–– Vue.js is a progressive, incrementally-adoptable JavaScript framework for building UI on the web.

  • Typescript photo Typescript

    TypeScript is a superset of JavaScript that compiles to clean JavaScript output.

  • TensorFlow photo TensorFlow

    An Open Source Machine Learning Framework for Everyone

  • Django photo Django

    The Web framework for perfectionists with deadlines.

  • D3 photo D3

    Bring data to life with SVG, Canvas and HTML. ๐Ÿ“Š๐Ÿ“ˆ๐ŸŽ‰

Recommend Topics

  • javascript

    JavaScript (JS) is a lightweight interpreted programming language with first-class functions.

  • web

    Some thing interesting about web. New door for the world.

  • server

    A server is a program made to process requests and deliver data to clients.

  • Machine learning

    Machine learning is a way of modeling and interpreting data that allows a piece of software to respond intelligently.

  • Game

    Some thing interesting about game, make everyone happy.

Recommend Org

  • Facebook photo Facebook

    We are working to build community through open source technology. NB: members must have two-factor auth.

  • Microsoft photo Microsoft

    Open source projects and samples from Microsoft.

  • Google photo Google

    Google โค๏ธ Open Source for everyone.

  • D3 photo D3

    Data-Driven Documents codes.