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

Commit 7d5ff59

Browse files
stuartmorgan-gstuartmorgan-g
authored
[tools] Require implementation package README warning (#6459)
1 parent 7992b0f commit 7d5ff59

File tree

51 files changed

+615
-235
lines changed

Some content is hidden

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

51 files changed

+615
-235
lines changed

‎packages/camera/camera_android_camerax/example/README.md

Lines changed: 8 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -1,3 +1,9 @@
1-
# camera_android_camerax_example
1+
# Platform Implementation Test App
22

3-
Demonstrates how to use the camera_android_camerax plugin.
3+
This is a test app for manual testing and automated integration testing
4+
of this platform implementation. It is not intended to demonstrate actual use of
5+
this package, since the intent is that plugin clients use the app-facing
6+
package.
7+
8+
Unless you are making changes to this implementation package, this example is
9+
very unlikely to be relevant.

‎packages/camera/camera_web/example/README.md

Lines changed: 12 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -1,9 +1,19 @@
1-
# Testing
1+
# Platform Implementation Test App
2+
3+
This is a test app for manual testing and automated integration testing
4+
of this platform implementation. It is not intended to demonstrate actual use of
5+
this package, since the intent is that plugin clients use the app-facing
6+
package.
7+
8+
Unless you are making changes to this implementation package, this example is
9+
very unlikely to be relevant.
10+
11+
## Testing
212

313
This package uses `package:integration_test` to run its tests in a web browser.
414

515
See [Plugin Tests > Web Tests](https://github.com/flutter/flutter/wiki/Plugin-Tests#web-tests)
616
in the Flutter wiki for instructions to setup and run the tests in this package.
717

818
Check [flutter.dev > Integration testing](https://flutter.dev/docs/testing/integration-tests)
9-
for more info.
19+
for more info.

‎packages/camera/camera_windows/example/README.md

Lines changed: 8 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -1,3 +1,9 @@
1-
# camera_windows_example
1+
# Platform Implementation Test App
22

3-
Demonstrates how to use the camera_windows plugin.
3+
This is a test app for manual testing and automated integration testing
4+
of this platform implementation. It is not intended to demonstrate actual use of
5+
this package, since the intent is that plugin clients use the app-facing
6+
package.
7+
8+
Unless you are making changes to this implementation package, this example is
9+
very unlikely to be relevant.

‎packages/file_selector/file_selector_ios/example/README.md

Lines changed: 8 additions & 3 deletions
Original file line numberDiff line numberDiff line change
@@ -1,4 +1,9 @@
1-
# `file_selector_ios` example
1+
# Platform Implementation Test App
22

3-
Demonstrates iOS implementation of the
4-
[`file_selector` plugin](https://pub.dev/packages/file_selector).
3+
This is a test app for manual testing and automated integration testing
4+
of this platform implementation. It is not intended to demonstrate actual use of
5+
this package, since the intent is that plugin clients use the app-facing
6+
package.
7+
8+
Unless you are making changes to this implementation package, this example is
9+
very unlikely to be relevant.

‎packages/file_selector/file_selector_linux/example/README.md

Lines changed: 8 additions & 3 deletions
Original file line numberDiff line numberDiff line change
@@ -1,4 +1,9 @@
1-
# `file_selector_linux` example
1+
# Platform Implementation Test App
22

3-
Demonstrates Linux implementation of the
4-
[`file_selector` plugin](https://pub.dev/packages/file_selector).
3+
This is a test app for manual testing and automated integration testing
4+
of this platform implementation. It is not intended to demonstrate actual use of
5+
this package, since the intent is that plugin clients use the app-facing
6+
package.
7+
8+
Unless you are making changes to this implementation package, this example is
9+
very unlikely to be relevant.

‎packages/file_selector/file_selector_macos/example/README.md

Lines changed: 8 additions & 3 deletions
Original file line numberDiff line numberDiff line change
@@ -1,4 +1,9 @@
1-
# `file_selector_macos` example
1+
# Platform Implementation Test App
22

3-
Demonstrates macOS implementation of the
4-
[`file_selector` plugin](https://pub.dev/packages/file_selector).
3+
This is a test app for manual testing and automated integration testing
4+
of this platform implementation. It is not intended to demonstrate actual use of
5+
this package, since the intent is that plugin clients use the app-facing
6+
package.
7+
8+
Unless you are making changes to this implementation package, this example is
9+
very unlikely to be relevant.

‎packages/file_selector/file_selector_web/example/README.md

Lines changed: 12 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -1,9 +1,19 @@
1-
# Testing
1+
# Platform Implementation Test App
2+
3+
This is a test app for manual testing and automated integration testing
4+
of this platform implementation. It is not intended to demonstrate actual use of
5+
this package, since the intent is that plugin clients use the app-facing
6+
package.
7+
8+
Unless you are making changes to this implementation package, this example is
9+
very unlikely to be relevant.
10+
11+
## Testing
212

313
This package uses `package:integration_test` to run its tests in a web browser.
414

515
See [Plugin Tests > Web Tests](https://github.com/flutter/flutter/wiki/Plugin-Tests#web-tests)
616
in the Flutter wiki for instructions to setup and run the tests in this package.
717

818
Check [flutter.dev > Integration testing](https://flutter.dev/docs/testing/integration-tests)
9-
for more info.
19+
for more info.

‎packages/file_selector/file_selector_windows/example/README.md

Lines changed: 8 additions & 3 deletions
Original file line numberDiff line numberDiff line change
@@ -1,4 +1,9 @@
1-
# `file_selector_windows` Example
1+
# Platform Implementation Test App
22

3-
Demonstrates Windows implementation of the
4-
[`file_selector` plugin](https://pub.dev/packages/file_selector).
3+
This is a test app for manual testing and automated integration testing
4+
of this platform implementation. It is not intended to demonstrate actual use of
5+
this package, since the intent is that plugin clients use the app-facing
6+
package.
7+
8+
Unless you are making changes to this implementation package, this example is
9+
very unlikely to be relevant.

‎packages/google_maps_flutter/google_maps_flutter_android/example/README.md

Lines changed: 8 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -1,3 +1,9 @@
1-
# google_maps_flutter_example
1+
# Platform Implementation Test App
22

3-
Demonstrates how to use the google_maps_flutter plugin.
3+
This is a test app for manual testing and automated integration testing
4+
of this platform implementation. It is not intended to demonstrate actual use of
5+
this package, since the intent is that plugin clients use the app-facing
6+
package.
7+
8+
Unless you are making changes to this implementation package, this example is
9+
very unlikely to be relevant.

‎packages/google_maps_flutter/google_maps_flutter_ios/example/README.md

Lines changed: 8 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -1,3 +1,9 @@
1-
# google_maps_flutter_example
1+
# Platform Implementation Test App
22

3-
Demonstrates how to use the google_maps_flutter plugin.
3+
This is a test app for manual testing and automated integration testing
4+
of this platform implementation. It is not intended to demonstrate actual use of
5+
this package, since the intent is that plugin clients use the app-facing
6+
package.
7+
8+
Unless you are making changes to this implementation package, this example is
9+
very unlikely to be relevant.

‎packages/google_maps_flutter/google_maps_flutter_web/example/README.md

Lines changed: 11 additions & 4 deletions
Original file line numberDiff line numberDiff line change
@@ -1,4 +1,14 @@
1-
# Testing
1+
# Platform Implementation Test App
2+
3+
This is a test app for manual testing and automated integration testing
4+
of this platform implementation. It is not intended to demonstrate actual use of
5+
this package, since the intent is that plugin clients use the app-facing
6+
package.
7+
8+
Unless you are making changes to this implementation package, this example is
9+
very unlikely to be relevant.
10+
11+
## Testing
212

313
This package uses `package:integration_test` to run its tests in a web browser.
414

@@ -7,6 +17,3 @@ in the Flutter wiki for instructions to setup and run the tests in this package.
717

818
Check [flutter.dev > Integration testing](https://flutter.dev/docs/testing/integration-tests)
919
for more info.
10-
11-
See [Plugin Tests > Web Tests > Mocks](https://github.com/flutter/flutter/wiki/Plugin-Tests#mocks)
12-
in the Flutter wiki for more information about the `.mocks.dart` files in this package.

‎packages/google_sign_in/google_sign_in_android/example/README.md

Lines changed: 8 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -1,3 +1,9 @@
1-
# google_sign_in_android example
1+
# Platform Implementation Test App
22

3-
Exercises the Android implementation of `GoogleSignInPlatform`.
3+
This is a test app for manual testing and automated integration testing
4+
of this platform implementation. It is not intended to demonstrate actual use of
5+
this package, since the intent is that plugin clients use the app-facing
6+
package.
7+
8+
Unless you are making changes to this implementation package, this example is
9+
very unlikely to be relevant.

‎packages/google_sign_in/google_sign_in_ios/example/README.md

Lines changed: 8 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -1,3 +1,9 @@
1-
# google_sign_in_ios example
1+
# Platform Implementation Test App
22

3-
Exercises the iOS implementation of `GoogleSignInPlatform`.
3+
This is a test app for manual testing and automated integration testing
4+
of this platform implementation. It is not intended to demonstrate actual use of
5+
this package, since the intent is that plugin clients use the app-facing
6+
package.
7+
8+
Unless you are making changes to this implementation package, this example is
9+
very unlikely to be relevant.

‎packages/google_sign_in/google_sign_in_web/example/README.md

Lines changed: 12 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -1,9 +1,19 @@
1-
# Testing
1+
# Platform Implementation Test App
2+
3+
This is a test app for manual testing and automated integration testing
4+
of this platform implementation. It is not intended to demonstrate actual use of
5+
this package, since the intent is that plugin clients use the app-facing
6+
package.
7+
8+
Unless you are making changes to this implementation package, this example is
9+
very unlikely to be relevant.
10+
11+
## Testing
212

313
This package uses `package:integration_test` to run its tests in a web browser.
414

515
See [Plugin Tests > Web Tests](https://github.com/flutter/flutter/wiki/Plugin-Tests#web-tests)
616
in the Flutter wiki for instructions to setup and run the tests in this package.
717

818
Check [flutter.dev > Integration testing](https://flutter.dev/docs/testing/integration-tests)
9-
for more info.
19+
for more info.

‎packages/image_picker/image_picker_android/example/README.md

Lines changed: 8 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -1,3 +1,9 @@
1-
# image_picker_example
1+
# Platform Implementation Test App
22

3-
Demonstrates how to use the `image_picker` plugin.
3+
This is a test app for manual testing and automated integration testing
4+
of this platform implementation. It is not intended to demonstrate actual use of
5+
this package, since the intent is that plugin clients use the app-facing
6+
package.
7+
8+
Unless you are making changes to this implementation package, this example is
9+
very unlikely to be relevant.

‎packages/image_picker/image_picker_for_web/example/README.md

Lines changed: 11 additions & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -1,4 +1,14 @@
1-
# Testing
1+
# Platform Implementation Test App
2+
3+
This is a test app for manual testing and automated integration testing
4+
of this platform implementation. It is not intended to demonstrate actual use of
5+
this package, since the intent is that plugin clients use the app-facing
6+
package.
7+
8+
Unless you are making changes to this implementation package, this example is
9+
very unlikely to be relevant.
10+
11+
## Testing
212

313
This package uses `package:integration_test` to run its tests in a web browser.
414

‎packages/image_picker/image_picker_ios/example/README.md

Lines changed: 8 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -1,3 +1,9 @@
1-
# image_picker_example
1+
# Platform Implementation Test App
22

3-
Demonstrates how to use the `image_picker` plugin.
3+
This is a test app for manual testing and automated integration testing
4+
of this platform implementation. It is not intended to demonstrate actual use of
5+
this package, since the intent is that plugin clients use the app-facing
6+
package.
7+
8+
Unless you are making changes to this implementation package, this example is
9+
very unlikely to be relevant.

‎packages/image_picker/image_picker_windows/example/README.md

Lines changed: 8 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -1,3 +1,9 @@
1-
# image_picker_windows_example
1+
# Platform Implementation Test App
22

3-
Demonstrates how to use the image_picker_windows plugin.
3+
This is a test app for manual testing and automated integration testing
4+
of this platform implementation. It is not intended to demonstrate actual use of
5+
this package, since the intent is that plugin clients use the app-facing
6+
package.
7+
8+
Unless you are making changes to this implementation package, this example is
9+
very unlikely to be relevant.

‎packages/in_app_purchase/in_app_purchase_android/example/README.md

Lines changed: 7 additions & 56 deletions
Original file line numberDiff line numberDiff line change
@@ -1,58 +1,9 @@
1-
# In App Purchase Example
1+
# Platform Implementation Test App
22

3-
Demonstrates how to use the In App Purchase Android (IAP) Plugin.
3+
This is a test app for manual testing and automated integration testing
4+
of this platform implementation. It is not intended to demonstrate actual use of
5+
this package, since the intent is that plugin clients use the app-facing
6+
package.
47

5-
## Getting Started
6-
7-
### Preparation
8-
9-
There's a significant amount of setup required for testing in-app purchases
10-
successfully, including registering new app IDs and store entries to use for
11-
testing in the Play Developer Console. Google Play requires developers to
12-
configure an app with in-app items for purchase to call their in-app-purchase
13-
APIs. The Google Play Store has extensive documentation on how to do this, and
14-
we've also included a high level guide below.
15-
16-
* [Google Play Billing Overview](https://developer.android.com/google/play/billing/billing_overview)
17-
18-
### Android
19-
20-
1. Create a new app in the [Play Developer
21-
Console](https://play.google.com/apps/publish/) (PDC).
22-
23-
2. Sign up for a merchant's account in the PDC.
24-
25-
3. Create IAPs in the PDC available for purchase in the app. The example assumes
26-
the following SKU IDs exist:
27-
28-
- `consumable`: A managed product.
29-
- `upgrade`: A managed product.
30-
- `subscription_silver`: A lower level subscription.
31-
- `subscription_gold`: A higher level subscription.
32-
33-
Make sure that all of the products are set to `ACTIVE`.
34-
35-
4. Update `APP_ID` in `example/android/app/build.gradle` to match your package
36-
ID in the PDC.
37-
38-
5. Create an `example/android/keystore.properties` file with all your signing
39-
information. `keystore.example.properties` exists as an example to follow.
40-
It's impossible to use any of the `BillingClient` APIs from an unsigned APK.
41-
See
42-
[here](https://developer.android.com/studio/publish/app-signing#secure-shared-keystore)
43-
and [here](https://developer.android.com/studio/publish/app-signing#sign-apk)
44-
for more information.
45-
46-
6. Build a signed apk. `flutter build apk` will work for this, the gradle files
47-
in this project have been configured to sign even debug builds.
48-
49-
7. Upload the signed APK from step 6 to the PDC, and publish that to the alpha
50-
test channel. Add your test account as an approved tester. The
51-
`BillingClient` APIs won't work unless the app has been fully published to
52-
the alpha channel and is being used by an authorized test account. See
53-
[here](https://support.google.com/googleplay/android-developer/answer/3131213)
54-
for more info.
55-
56-
8. Sign in to the test device with the test account from step #7. Then use
57-
`flutter run` to install the app to the device and test like normal.
58-
8+
Unless you are making changes to this implementation package, this example is
9+
very unlikely to be relevant.

0 commit comments

Comments
 (0)