Release v1.0.0

[dwillmc]

This is the v1.0.0 Release of CameraKit. This release embodies over 9 months of work, with massive refactors to all parts of the codebase. This PR and changelog are not complete, yet.

Test the PR

Ready to test:

• Camera Preview
• Runtime permissions
• Photos

Still Coming

• setMethod() function on cameraView

Dependency

// Add our snapshot repository.
repositories {
    maven { url 'https://dl.bintray.com/camerakit/camerakit-android-snapshots' }
}

// Make sure snapshots won't get cached.
configurations.all {
    resolutionStrategy.cacheChangingModulesFor 0, 'seconds'
}

dependencies {
    implementation group: 'com.camerakit', name:'camerakit', version:'1.0.0-Snapshot', changing: true
}

Add a CameraKitView

Make sure everything looks proper with any phone rotation, while screen orientation is on auto-rotate or locked.
Open and close the app drawer and dismiss the app to make sure the camera stops and starts properly.

Basic fullscreen CameraKitView:

<com.camerakit.CameraKitView xmlns:app="http://schemas.android.com/apk/res-auto"
    android:id="@+id/camera"
    android:layout_width="match_parent"
    android:layout_height="match_parent"
    app:camera_facing="back" />

CameraKitView that adjusts dimenions to perfectly match previews true aspect ratio - nothing cut-off:

<com.camerakit.CameraKitView xmlns:app="http://schemas.android.com/apk/res-auto"
    android:id="@+id/camera"
    android:layout_width="match_parent"
    android:layout_height="wrap_content"
    android:adjustViewBounds="true"
    app:camera_facing="back" />

Square CameraKitView using app:camera_aspectRatio:

<com.camerakit.CameraKitView xmlns:app="http://schemas.android.com/apk/res-auto"
    android:id="@+id/camera"
    android:layout_width="match_parent"
    android:layout_height="wrap_content"
    android:adjustViewBounds="true"
    app:camera_aspectRatio="1:1"
    app:camera_facing="back" />

MainActivity

Bind the CameraKitView into your activity and implement pass-through methods for onResume(), onPause(), and if you want the CameraKitView to automatically handle runtime permissions, onRequestPermissionsResult(int requestCode, String[] permissions, int[] grantResults).

public class MainActivity extends AppCompatActivity {
    
    private CameraKitView cameraKitView;

    @Override
    protected void onCreate(Bundle savedInstanceState) {
        super.onCreate(savedInstanceState);
        setContentView(R.layout.activity_main);
        cameraKitView = findViewById(R.id.camera);
    }

    @Override
    protected void onResume() {
        super.onResume();
        cameraKitView.onResume();
    }

    @Override
    protected void onPause() {
        cameraKitView.onPause();
        super.onPause();
    }

    @Override
    public void onRequestPermissionsResult(int requestCode, @NonNull String[] permissions, @NonNull int[] grantResults) {
        super.onRequestPermissionsResult(requestCode, permissions, grantResults);
        cameraKitView.onRequestPermissionsResult(requestCode, permissions, grantResults);
    }
    
}

[austinkettner]

@developer-- @sagartrehan @p-canniff @athomaj @carrotow @ritesh94 @shoomkloom @lukaspili @mjf009 @rt-bloombees @snkashis @jondoes @rencsaridogan @virengujariya @ritesh94 @Pomis

Would love your testing and feedback since you have issues in the 1.0.0 Milestone that should be resolved by this!

[austinkettner]

Usage instructions have been added to PR notes.

[Danm72]

I've noticed that the orientation of the saved images doesn't match the orientation of the preview.

[austinkettner]

Hi All,

We are merging this and moving to a new v1.0.0-beta4 branch + develop branch to better follow Git Flow going forward. We are doubling down on wrapping up v1.0.0 soon and this is the first step, to move past this long drawn out PR and move to more incremental PRs.

We will also be moving to Apache vs MIT (in our new branches) to enable Pull Requests from other users. Mentioning here as we are open to feedback before making this change and if anyone has an issue with this please comment or email us at hello [at] camerakit.io -- we are super open to any feedback here but have heard many would prefer Apache.

[Zaniyar]

Hi @austinkettner, onFrameData callback is not implemented yet? Is it on the agenda? thx

[Bajranghudda1]

As of now best result can be manually stopping camera on config change and then restart the camera is the best solution. for eg. -

override fun onConfigurationChanged(newConfig: Configuration) {
super.onConfigurationChanged(newConfig)
mBinding.cameraView.stop()
mBinding.cameraView.stopVideo()
mBinding.cameraView.start()
}

[dimanych]

Hi there, in https://dl.bintray.com/camerakit/camerakit-android-snapshots/com/camerakit/camerakit/1.0.0-Snapshot/:camerakit-1.0.0-Snapshot.aar forbidden.
Where can I load aar? Thanks