Mercurial > dwindows
annotate mobile.txt @ 2993:392f0b3dd502
Android: Add DW_FEATURE_RENDER_SAFE, initially just for Android.
This will eventually be supported on other platforms that support unsafe
rendering. On Android this moves EXPOSE events off the main thread and is
enabled by default to provide extra safety. Since none of the callbacks
happen on the main thread anymore, this means that none of the threading
functions follow the potentially unsafe code paths that lead to instability.
The trade off is performance, rendering performance, which was already kind
of slow is even worse. I'll look for ways to improve this performance
without sacrificing stability.
author | bsmith@81767d24-ef19-dc11-ae90-00e081727c95 |
---|---|
date | Tue, 02 May 2023 11:37:48 +0000 |
parents | ebb94fc2b19f |
children |
rev | line source |
---|---|
2671
0ed61ddb9957
Add a mobile platform text file with instructions on how to create projects.
bsmith@81767d24-ef19-dc11-ae90-00e081727c95
parents:
diff
changeset
|
1 How to create a Dynamic Windows project for iOS in Xcode and Android in Android Studio. |
0ed61ddb9957
Add a mobile platform text file with instructions on how to create projects.
bsmith@81767d24-ef19-dc11-ae90-00e081727c95
parents:
diff
changeset
|
2 |
0ed61ddb9957
Add a mobile platform text file with instructions on how to create projects.
bsmith@81767d24-ef19-dc11-ae90-00e081727c95
parents:
diff
changeset
|
3 |
0ed61ddb9957
Add a mobile platform text file with instructions on how to create projects.
bsmith@81767d24-ef19-dc11-ae90-00e081727c95
parents:
diff
changeset
|
4 Xcode |
0ed61ddb9957
Add a mobile platform text file with instructions on how to create projects.
bsmith@81767d24-ef19-dc11-ae90-00e081727c95
parents:
diff
changeset
|
5 |
0ed61ddb9957
Add a mobile platform text file with instructions on how to create projects.
bsmith@81767d24-ef19-dc11-ae90-00e081727c95
parents:
diff
changeset
|
6 === Dynamic Windows Project Creation === |
2672
d2c3b17a4ddf
Remove the unicode characters that LibreOffice put into the text.
bsmith@81767d24-ef19-dc11-ae90-00e081727c95
parents:
2671
diff
changeset
|
7 1. File -> New -> Project... |
d2c3b17a4ddf
Remove the unicode characters that LibreOffice put into the text.
bsmith@81767d24-ef19-dc11-ae90-00e081727c95
parents:
2671
diff
changeset
|
8 2. Select "iOS" then "App" then click "Next" |
2671
0ed61ddb9957
Add a mobile platform text file with instructions on how to create projects.
bsmith@81767d24-ef19-dc11-ae90-00e081727c95
parents:
diff
changeset
|
9 3. Fill in the following: |
2875
d15517b49638
Update the mobile document with updated information for 3.3.
bsmith@81767d24-ef19-dc11-ae90-00e081727c95
parents:
2674
diff
changeset
|
10 "Product Name" with "Dynamic Windows iOS" |
d15517b49638
Update the mobile document with updated information for 3.3.
bsmith@81767d24-ef19-dc11-ae90-00e081727c95
parents:
2674
diff
changeset
|
11 "Team" select the appropriate team for this project. |
d15517b49638
Update the mobile document with updated information for 3.3.
bsmith@81767d24-ef19-dc11-ae90-00e081727c95
parents:
2674
diff
changeset
|
12 "Organization Identifier" with "org.dbsoft" |
d15517b49638
Update the mobile document with updated information for 3.3.
bsmith@81767d24-ef19-dc11-ae90-00e081727c95
parents:
2674
diff
changeset
|
13 "Interface" select "Storyboard" |
d15517b49638
Update the mobile document with updated information for 3.3.
bsmith@81767d24-ef19-dc11-ae90-00e081727c95
parents:
2674
diff
changeset
|
14 "Language" select "Objective-C" |
d15517b49638
Update the mobile document with updated information for 3.3.
bsmith@81767d24-ef19-dc11-ae90-00e081727c95
parents:
2674
diff
changeset
|
15 Uncheck "Include Tests" and click "Next" |
2673
a39e2ea6fa14
iOS: Only add the "Back" button to the Navigation Bar if the window has the
bsmith@81767d24-ef19-dc11-ae90-00e081727c95
parents:
2672
diff
changeset
|
16 4. Choose a location for the project, "Don't add to any project or workspace" |
2672
d2c3b17a4ddf
Remove the unicode characters that LibreOffice put into the text.
bsmith@81767d24-ef19-dc11-ae90-00e081727c95
parents:
2671
diff
changeset
|
17 5. Rename the "Dynamic Windows iOS" target to "dwtest" and remove the following files: |
2875
d15517b49638
Update the mobile document with updated information for 3.3.
bsmith@81767d24-ef19-dc11-ae90-00e081727c95
parents:
2674
diff
changeset
|
18 *.m, *.h, *.storyboard and Assets.xcassets |
2672
d2c3b17a4ddf
Remove the unicode characters that LibreOffice put into the text.
bsmith@81767d24-ef19-dc11-ae90-00e081727c95
parents:
2671
diff
changeset
|
19 6. Select "dwtest" folder and File -> Add Files to "Dynamic Windows iOS"... |
2875
d15517b49638
Update the mobile document with updated information for 3.3.
bsmith@81767d24-ef19-dc11-ae90-00e081727c95
parents:
2674
diff
changeset
|
20 Select "dwtest.c" from the file dialog with "Copy items if needed" unchecked. |
d15517b49638
Update the mobile document with updated information for 3.3.
bsmith@81767d24-ef19-dc11-ae90-00e081727c95
parents:
2674
diff
changeset
|
21 "Add to targets" should have "dwtest" checked. |
2672
d2c3b17a4ddf
Remove the unicode characters that LibreOffice put into the text.
bsmith@81767d24-ef19-dc11-ae90-00e081727c95
parents:
2671
diff
changeset
|
22 7. Highlight the project "Dynamic Windows iOS" in the top left then select the target "dwtest" |
2875
d15517b49638
Update the mobile document with updated information for 3.3.
bsmith@81767d24-ef19-dc11-ae90-00e081727c95
parents:
2674
diff
changeset
|
23 Edit "Bundle Identifier" to be "org.dbsoft.dwindows.dwtest" |
2672
d2c3b17a4ddf
Remove the unicode characters that LibreOffice put into the text.
bsmith@81767d24-ef19-dc11-ae90-00e081727c95
parents:
2671
diff
changeset
|
24 8. Click the target dropdown and click "Add Target" |
2875
d15517b49638
Update the mobile document with updated information for 3.3.
bsmith@81767d24-ef19-dc11-ae90-00e081727c95
parents:
2674
diff
changeset
|
25 Select "Framework" and click "Next" |
d15517b49638
Update the mobile document with updated information for 3.3.
bsmith@81767d24-ef19-dc11-ae90-00e081727c95
parents:
2674
diff
changeset
|
26 "Product name" with "dwindows" uncheck "Include Tests" |
2672
d2c3b17a4ddf
Remove the unicode characters that LibreOffice put into the text.
bsmith@81767d24-ef19-dc11-ae90-00e081727c95
parents:
2671
diff
changeset
|
27 9. Delete the created "dwindows.h" and "Move to Trash" |
d2c3b17a4ddf
Remove the unicode characters that LibreOffice put into the text.
bsmith@81767d24-ef19-dc11-ae90-00e081727c95
parents:
2671
diff
changeset
|
28 10. Select "dwindows" folder and File -> Add Files to "Dynamic Windows iOS"... |
2875
d15517b49638
Update the mobile document with updated information for 3.3.
bsmith@81767d24-ef19-dc11-ae90-00e081727c95
parents:
2674
diff
changeset
|
29 Add "dw.h" and "ios/dw.m" with "Copy items if needed" unchecked. |
2672
d2c3b17a4ddf
Remove the unicode characters that LibreOffice put into the text.
bsmith@81767d24-ef19-dc11-ae90-00e081727c95
parents:
2671
diff
changeset
|
30 11. Repeat steps 8 through 10 with "dwcompat" adding the dwcompat.c and dwcompat.h files. |
d2c3b17a4ddf
Remove the unicode characters that LibreOffice put into the text.
bsmith@81767d24-ef19-dc11-ae90-00e081727c95
parents:
2671
diff
changeset
|
31 12. Highlight the project "Dynamic Windows iOS" in the top left then select the main project. |
2875
d15517b49638
Update the mobile document with updated information for 3.3.
bsmith@81767d24-ef19-dc11-ae90-00e081727c95
parents:
2674
diff
changeset
|
32 Click "Build Settings" for the entire project and find "Apple Clang - Preprocessing" |
d15517b49638
Update the mobile document with updated information for 3.3.
bsmith@81767d24-ef19-dc11-ae90-00e081727c95
parents:
2674
diff
changeset
|
33 Double click "Preprocessor Macros" and add "__IOS__" to the list for release and debug. |
d15517b49638
Update the mobile document with updated information for 3.3.
bsmith@81767d24-ef19-dc11-ae90-00e081727c95
parents:
2674
diff
changeset
|
34 13. Edit the "Info.plist" in "dwtest" and remove all the settings below "Bundle version" |
d15517b49638
Update the mobile document with updated information for 3.3.
bsmith@81767d24-ef19-dc11-ae90-00e081727c95
parents:
2674
diff
changeset
|
35 This is required because Dynamic Windows does not use storyboards. |
d15517b49638
Update the mobile document with updated information for 3.3.
bsmith@81767d24-ef19-dc11-ae90-00e081727c95
parents:
2674
diff
changeset
|
36 If necessary edit the "dwtest" "Build Settings" and correct the path to "dwtest/Info.plist" |
d15517b49638
Update the mobile document with updated information for 3.3.
bsmith@81767d24-ef19-dc11-ae90-00e081727c95
parents:
2674
diff
changeset
|
37 14. Highlight the project "Dynamic Windows iOS" in the top left then File -> New -> Group |
d15517b49638
Update the mobile document with updated information for 3.3.
bsmith@81767d24-ef19-dc11-ae90-00e081727c95
parents:
2674
diff
changeset
|
38 Name the new group "Resources" |
d15517b49638
Update the mobile document with updated information for 3.3.
bsmith@81767d24-ef19-dc11-ae90-00e081727c95
parents:
2674
diff
changeset
|
39 Copy "mac/file.png" "mac/folder.png" and "image/test.png" into "Resources" |
2671
0ed61ddb9957
Add a mobile platform text file with instructions on how to create projects.
bsmith@81767d24-ef19-dc11-ae90-00e081727c95
parents:
diff
changeset
|
40 |
0ed61ddb9957
Add a mobile platform text file with instructions on how to create projects.
bsmith@81767d24-ef19-dc11-ae90-00e081727c95
parents:
diff
changeset
|
41 === Project Creation === |
2672
d2c3b17a4ddf
Remove the unicode characters that LibreOffice put into the text.
bsmith@81767d24-ef19-dc11-ae90-00e081727c95
parents:
2671
diff
changeset
|
42 1. File -> New -> Project... |
d2c3b17a4ddf
Remove the unicode characters that LibreOffice put into the text.
bsmith@81767d24-ef19-dc11-ae90-00e081727c95
parents:
2671
diff
changeset
|
43 2. Select "iOS" then "App" then click "Next" |
2671
0ed61ddb9957
Add a mobile platform text file with instructions on how to create projects.
bsmith@81767d24-ef19-dc11-ae90-00e081727c95
parents:
diff
changeset
|
44 3. Fill in the following: |
2875
d15517b49638
Update the mobile document with updated information for 3.3.
bsmith@81767d24-ef19-dc11-ae90-00e081727c95
parents:
2674
diff
changeset
|
45 "Product Name" with your application name. |
d15517b49638
Update the mobile document with updated information for 3.3.
bsmith@81767d24-ef19-dc11-ae90-00e081727c95
parents:
2674
diff
changeset
|
46 "Team" select the appropriate team for this project. |
d15517b49638
Update the mobile document with updated information for 3.3.
bsmith@81767d24-ef19-dc11-ae90-00e081727c95
parents:
2674
diff
changeset
|
47 "Organization Identifier" with your identifier |
d15517b49638
Update the mobile document with updated information for 3.3.
bsmith@81767d24-ef19-dc11-ae90-00e081727c95
parents:
2674
diff
changeset
|
48 "Interface" select "Storyboard" |
d15517b49638
Update the mobile document with updated information for 3.3.
bsmith@81767d24-ef19-dc11-ae90-00e081727c95
parents:
2674
diff
changeset
|
49 "Language" select "Objective-C" |
d15517b49638
Update the mobile document with updated information for 3.3.
bsmith@81767d24-ef19-dc11-ae90-00e081727c95
parents:
2674
diff
changeset
|
50 Uncheck "Include Tests" and click "Next" |
2673
a39e2ea6fa14
iOS: Only add the "Back" button to the Navigation Bar if the window has the
bsmith@81767d24-ef19-dc11-ae90-00e081727c95
parents:
2672
diff
changeset
|
51 4. Choose a location for the project, "Don't add to any project or workspace" |
2672
d2c3b17a4ddf
Remove the unicode characters that LibreOffice put into the text.
bsmith@81767d24-ef19-dc11-ae90-00e081727c95
parents:
2671
diff
changeset
|
52 5. Make sure you close the "Dynamic Windows iOS" main project before step 6. |
d2c3b17a4ddf
Remove the unicode characters that LibreOffice put into the text.
bsmith@81767d24-ef19-dc11-ae90-00e081727c95
parents:
2671
diff
changeset
|
53 6. Select the project in the top left and File -> Add Files to "Project Name"... |
2875
d15517b49638
Update the mobile document with updated information for 3.3.
bsmith@81767d24-ef19-dc11-ae90-00e081727c95
parents:
2674
diff
changeset
|
54 Find the "Dynamic Windows iOS" project and add it to the application project. |
2672
d2c3b17a4ddf
Remove the unicode characters that LibreOffice put into the text.
bsmith@81767d24-ef19-dc11-ae90-00e081727c95
parents:
2671
diff
changeset
|
55 7. Select the Project folder and File -> Add Files to "Project Name"... |
2875
d15517b49638
Update the mobile document with updated information for 3.3.
bsmith@81767d24-ef19-dc11-ae90-00e081727c95
parents:
2674
diff
changeset
|
56 Add your source files with "Copy items if needed" unchecked. |
2672
d2c3b17a4ddf
Remove the unicode characters that LibreOffice put into the text.
bsmith@81767d24-ef19-dc11-ae90-00e081727c95
parents:
2671
diff
changeset
|
57 8. Edit the "Info.plist" in the Project and remove all the settings below "Bundle version" |
2875
d15517b49638
Update the mobile document with updated information for 3.3.
bsmith@81767d24-ef19-dc11-ae90-00e081727c95
parents:
2674
diff
changeset
|
58 This is required because Dynamic Windows does not use storyboards. |
2672
d2c3b17a4ddf
Remove the unicode characters that LibreOffice put into the text.
bsmith@81767d24-ef19-dc11-ae90-00e081727c95
parents:
2671
diff
changeset
|
59 9. Highlight the Project Name in the top left then File -> New -> Group |
2875
d15517b49638
Update the mobile document with updated information for 3.3.
bsmith@81767d24-ef19-dc11-ae90-00e081727c95
parents:
2674
diff
changeset
|
60 Name the new group "Resources" |
2672
d2c3b17a4ddf
Remove the unicode characters that LibreOffice put into the text.
bsmith@81767d24-ef19-dc11-ae90-00e081727c95
parents:
2671
diff
changeset
|
61 10. Place any application resource images in the form "#.png" where # is the resource ID. |
2875
d15517b49638
Update the mobile document with updated information for 3.3.
bsmith@81767d24-ef19-dc11-ae90-00e081727c95
parents:
2674
diff
changeset
|
62 Any other application files placed here will be accessible via dw_app_dir() at runtime. |
2671
0ed61ddb9957
Add a mobile platform text file with instructions on how to create projects.
bsmith@81767d24-ef19-dc11-ae90-00e081727c95
parents:
diff
changeset
|
63 11. Open Assets.xcassets and drag the appropriate icons into the bottom sections. |
0ed61ddb9957
Add a mobile platform text file with instructions on how to create projects.
bsmith@81767d24-ef19-dc11-ae90-00e081727c95
parents:
diff
changeset
|
64 12. Select the project in the top left and select the application target from the drop down list. |
2875
d15517b49638
Update the mobile document with updated information for 3.3.
bsmith@81767d24-ef19-dc11-ae90-00e081727c95
parents:
2674
diff
changeset
|
65 Under "General" find "Frameworks, Libraries and Embedded Content" |
d15517b49638
Update the mobile document with updated information for 3.3.
bsmith@81767d24-ef19-dc11-ae90-00e081727c95
parents:
2674
diff
changeset
|
66 Add "dwindows.framework" from the "Dynamic Windows iOS" project. |
d15517b49638
Update the mobile document with updated information for 3.3.
bsmith@81767d24-ef19-dc11-ae90-00e081727c95
parents:
2674
diff
changeset
|
67 If necessary add "dwcompat.framework" from the Dynamic Windows iOS" project. |
2671
0ed61ddb9957
Add a mobile platform text file with instructions on how to create projects.
bsmith@81767d24-ef19-dc11-ae90-00e081727c95
parents:
diff
changeset
|
68 13. Highlight the project name in the top left then select the main project. |
2875
d15517b49638
Update the mobile document with updated information for 3.3.
bsmith@81767d24-ef19-dc11-ae90-00e081727c95
parents:
2674
diff
changeset
|
69 Click "Info" and set the "iOS Deployment Target" to "13.0" |
2672
d2c3b17a4ddf
Remove the unicode characters that LibreOffice put into the text.
bsmith@81767d24-ef19-dc11-ae90-00e081727c95
parents:
2671
diff
changeset
|
70 14. Click "Build Settings" for the entire project and find "Search Paths" and add the path to |
2875
d15517b49638
Update the mobile document with updated information for 3.3.
bsmith@81767d24-ef19-dc11-ae90-00e081727c95
parents:
2674
diff
changeset
|
71 dw.h in "Header Search Paths" for Release and Debug (Any Architecture | Any SDK) |
2672
d2c3b17a4ddf
Remove the unicode characters that LibreOffice put into the text.
bsmith@81767d24-ef19-dc11-ae90-00e081727c95
parents:
2671
diff
changeset
|
72 15. Also under "Build Settings" find "Apple Clang – Preprocessing" |
2875
d15517b49638
Update the mobile document with updated information for 3.3.
bsmith@81767d24-ef19-dc11-ae90-00e081727c95
parents:
2674
diff
changeset
|
73 Double click "Preprocessor Macros" and add "__IOS__" to the list for release and debug. |
2671
0ed61ddb9957
Add a mobile platform text file with instructions on how to create projects.
bsmith@81767d24-ef19-dc11-ae90-00e081727c95
parents:
diff
changeset
|
74 |
0ed61ddb9957
Add a mobile platform text file with instructions on how to create projects.
bsmith@81767d24-ef19-dc11-ae90-00e081727c95
parents:
diff
changeset
|
75 |
0ed61ddb9957
Add a mobile platform text file with instructions on how to create projects.
bsmith@81767d24-ef19-dc11-ae90-00e081727c95
parents:
diff
changeset
|
76 Android Studio |
0ed61ddb9957
Add a mobile platform text file with instructions on how to create projects.
bsmith@81767d24-ef19-dc11-ae90-00e081727c95
parents:
diff
changeset
|
77 |
0ed61ddb9957
Add a mobile platform text file with instructions on how to create projects.
bsmith@81767d24-ef19-dc11-ae90-00e081727c95
parents:
diff
changeset
|
78 === Project Creation === |
2672
d2c3b17a4ddf
Remove the unicode characters that LibreOffice put into the text.
bsmith@81767d24-ef19-dc11-ae90-00e081727c95
parents:
2671
diff
changeset
|
79 1. File -> New -> New Project |
d2c3b17a4ddf
Remove the unicode characters that LibreOffice put into the text.
bsmith@81767d24-ef19-dc11-ae90-00e081727c95
parents:
2671
diff
changeset
|
80 2. Select "Phone and Tablet" then "Native C++" and click "Next" |
2671
0ed61ddb9957
Add a mobile platform text file with instructions on how to create projects.
bsmith@81767d24-ef19-dc11-ae90-00e081727c95
parents:
diff
changeset
|
81 3. Fill in the following: |
2875
d15517b49638
Update the mobile document with updated information for 3.3.
bsmith@81767d24-ef19-dc11-ae90-00e081727c95
parents:
2674
diff
changeset
|
82 "Name" with your own application name |
d15517b49638
Update the mobile document with updated information for 3.3.
bsmith@81767d24-ef19-dc11-ae90-00e081727c95
parents:
2674
diff
changeset
|
83 "Package name" with "org.dbsoft.dwindows" |
d15517b49638
Update the mobile document with updated information for 3.3.
bsmith@81767d24-ef19-dc11-ae90-00e081727c95
parents:
2674
diff
changeset
|
84 "Save location" can be the default |
d15517b49638
Update the mobile document with updated information for 3.3.
bsmith@81767d24-ef19-dc11-ae90-00e081727c95
parents:
2674
diff
changeset
|
85 "Language" select "Kotlin" |
2984
ebb94fc2b19f
Android: Implement the DW_FEATURE_HTML_MESSAGE feature tests.
bsmith@81767d24-ef19-dc11-ae90-00e081727c95
parents:
2875
diff
changeset
|
86 "Minimum SDK" select "API 26: Android 8.0 (Oreo)" |
2875
d15517b49638
Update the mobile document with updated information for 3.3.
bsmith@81767d24-ef19-dc11-ae90-00e081727c95
parents:
2674
diff
changeset
|
87 click "Next" |
2672
d2c3b17a4ddf
Remove the unicode characters that LibreOffice put into the text.
bsmith@81767d24-ef19-dc11-ae90-00e081727c95
parents:
2671
diff
changeset
|
88 4. Select "Toolchain Default" and click "Finish" |
2671
0ed61ddb9957
Add a mobile platform text file with instructions on how to create projects.
bsmith@81767d24-ef19-dc11-ae90-00e081727c95
parents:
diff
changeset
|
89 |
0ed61ddb9957
Add a mobile platform text file with instructions on how to create projects.
bsmith@81767d24-ef19-dc11-ae90-00e081727c95
parents:
diff
changeset
|
90 === Source File Installation === |
2672
d2c3b17a4ddf
Remove the unicode characters that LibreOffice put into the text.
bsmith@81767d24-ef19-dc11-ae90-00e081727c95
parents:
2671
diff
changeset
|
91 5. Install "android/DWindows.kt" into "app/src/main/java/org/dbsoft/dwindows" |
2875
d15517b49638
Update the mobile document with updated information for 3.3.
bsmith@81767d24-ef19-dc11-ae90-00e081727c95
parents:
2674
diff
changeset
|
92 Remove "MainActivity.kt" from app/src/main/java/org/dbsoft/dwindows" |
2672
d2c3b17a4ddf
Remove the unicode characters that LibreOffice put into the text.
bsmith@81767d24-ef19-dc11-ae90-00e081727c95
parents:
2671
diff
changeset
|
93 6. Install "dw.h" and "android/dw.cpp" into "app/src/main/cpp" |
2875
d15517b49638
Update the mobile document with updated information for 3.3.
bsmith@81767d24-ef19-dc11-ae90-00e081727c95
parents:
2674
diff
changeset
|
94 Remove "native-lib.cpp" from "app/src/main/cpp" |
2672
d2c3b17a4ddf
Remove the unicode characters that LibreOffice put into the text.
bsmith@81767d24-ef19-dc11-ae90-00e081727c95
parents:
2671
diff
changeset
|
95 7. Optionally install "dwcompat.h" and "dwcompat.c" into "app/src/main/cpp" |
d2c3b17a4ddf
Remove the unicode characters that LibreOffice put into the text.
bsmith@81767d24-ef19-dc11-ae90-00e081727c95
parents:
2671
diff
changeset
|
96 8. Install your source files (or our example "dwtest.c") into "app/src/main/cpp" |
d2c3b17a4ddf
Remove the unicode characters that LibreOffice put into the text.
bsmith@81767d24-ef19-dc11-ae90-00e081727c95
parents:
2671
diff
changeset
|
97 9. Right click "app" in your project and click New -> Folder -> Assets Folder |
2875
d15517b49638
Update the mobile document with updated information for 3.3.
bsmith@81767d24-ef19-dc11-ae90-00e081727c95
parents:
2674
diff
changeset
|
98 "Target Source Set" select "main" and click "Finish" |
2672
d2c3b17a4ddf
Remove the unicode characters that LibreOffice put into the text.
bsmith@81767d24-ef19-dc11-ae90-00e081727c95
parents:
2671
diff
changeset
|
99 10. Place any application resource images in the form "#.png" where # is the resource ID. |
2875
d15517b49638
Update the mobile document with updated information for 3.3.
bsmith@81767d24-ef19-dc11-ae90-00e081727c95
parents:
2674
diff
changeset
|
100 Any other application files placed here will be accessible via dw_app_dir() at runtime. |
2671
0ed61ddb9957
Add a mobile platform text file with instructions on how to create projects.
bsmith@81767d24-ef19-dc11-ae90-00e081727c95
parents:
diff
changeset
|
101 |
0ed61ddb9957
Add a mobile platform text file with instructions on how to create projects.
bsmith@81767d24-ef19-dc11-ae90-00e081727c95
parents:
diff
changeset
|
102 === Project Configuration === |
2672
d2c3b17a4ddf
Remove the unicode characters that LibreOffice put into the text.
bsmith@81767d24-ef19-dc11-ae90-00e081727c95
parents:
2671
diff
changeset
|
103 11. Open "app/manifests/AndroidManifest.xml" and in the "activity" section |
2875
d15517b49638
Update the mobile document with updated information for 3.3.
bsmith@81767d24-ef19-dc11-ae90-00e081727c95
parents:
2674
diff
changeset
|
104 change "android:name" from ".MainActivity" to ".DWindows" |
2671
0ed61ddb9957
Add a mobile platform text file with instructions on how to create projects.
bsmith@81767d24-ef19-dc11-ae90-00e081727c95
parents:
diff
changeset
|
105 12. Recommend adding the following (but depends on the app usage): |
2875
d15517b49638
Update the mobile document with updated information for 3.3.
bsmith@81767d24-ef19-dc11-ae90-00e081727c95
parents:
2674
diff
changeset
|
106 android:configChanges="orientation|screenSize|screenLayout|keyboardHidden" |
d15517b49638
Update the mobile document with updated information for 3.3.
bsmith@81767d24-ef19-dc11-ae90-00e081727c95
parents:
2674
diff
changeset
|
107 android:screenOrientation="fullSensor" |
d15517b49638
Update the mobile document with updated information for 3.3.
bsmith@81767d24-ef19-dc11-ae90-00e081727c95
parents:
2674
diff
changeset
|
108 android:persistent="true" |
d15517b49638
Update the mobile document with updated information for 3.3.
bsmith@81767d24-ef19-dc11-ae90-00e081727c95
parents:
2674
diff
changeset
|
109 android:exported="true" |
d15517b49638
Update the mobile document with updated information for 3.3.
bsmith@81767d24-ef19-dc11-ae90-00e081727c95
parents:
2674
diff
changeset
|
110 android:usesCleartextTraffic="true" |
2672
d2c3b17a4ddf
Remove the unicode characters that LibreOffice put into the text.
bsmith@81767d24-ef19-dc11-ae90-00e081727c95
parents:
2671
diff
changeset
|
111 13: Open "app/src/main/cpp/CMakeLists.txt" and in the add_library() section: |
2875
d15517b49638
Update the mobile document with updated information for 3.3.
bsmith@81767d24-ef19-dc11-ae90-00e081727c95
parents:
2674
diff
changeset
|
112 Remove "native-lib.cpp" and add "dw.cpp" optionally "dwcompat.c" and your applications C |
d15517b49638
Update the mobile document with updated information for 3.3.
bsmith@81767d24-ef19-dc11-ae90-00e081727c95
parents:
2674
diff
changeset
|
113 or C++ source files that you had installed in step 8. |
d15517b49638
Update the mobile document with updated information for 3.3.
bsmith@81767d24-ef19-dc11-ae90-00e081727c95
parents:
2674
diff
changeset
|
114 Also change "project()" to be your project name. |
2672
d2c3b17a4ddf
Remove the unicode characters that LibreOffice put into the text.
bsmith@81767d24-ef19-dc11-ae90-00e081727c95
parents:
2671
diff
changeset
|
115 14. Open "build.gradle (Module)" in "Gradle Scripts" and change "applicationId" to your App ID. |
2671
0ed61ddb9957
Add a mobile platform text file with instructions on how to create projects.
bsmith@81767d24-ef19-dc11-ae90-00e081727c95
parents:
diff
changeset
|
116 |
0ed61ddb9957
Add a mobile platform text file with instructions on how to create projects.
bsmith@81767d24-ef19-dc11-ae90-00e081727c95
parents:
diff
changeset
|
117 === Application Assets === |
2672
d2c3b17a4ddf
Remove the unicode characters that LibreOffice put into the text.
bsmith@81767d24-ef19-dc11-ae90-00e081727c95
parents:
2671
diff
changeset
|
118 15. Remove all the files under "app/res/mipmap/ic_launcher" and app/res/mipmap/ic_launcher_round" |
d2c3b17a4ddf
Remove the unicode characters that LibreOffice put into the text.
bsmith@81767d24-ef19-dc11-ae90-00e081727c95
parents:
2671
diff
changeset
|
119 16. Right click "app" and click New -> Image Asset |
2875
d15517b49638
Update the mobile document with updated information for 3.3.
bsmith@81767d24-ef19-dc11-ae90-00e081727c95
parents:
2674
diff
changeset
|
120 "Icon Type" select "Launcher Icons (Legacy Only)" |
d15517b49638
Update the mobile document with updated information for 3.3.
bsmith@81767d24-ef19-dc11-ae90-00e081727c95
parents:
2674
diff
changeset
|
121 "Name" enter "ic_launcher" |
d15517b49638
Update the mobile document with updated information for 3.3.
bsmith@81767d24-ef19-dc11-ae90-00e081727c95
parents:
2674
diff
changeset
|
122 "Asset Type" check "Image" |
d15517b49638
Update the mobile document with updated information for 3.3.
bsmith@81767d24-ef19-dc11-ae90-00e081727c95
parents:
2674
diff
changeset
|
123 "Path" click the folder icon and select the largest launcher image you have. |
d15517b49638
Update the mobile document with updated information for 3.3.
bsmith@81767d24-ef19-dc11-ae90-00e081727c95
parents:
2674
diff
changeset
|
124 "Shape" select "Square" |
d15517b49638
Update the mobile document with updated information for 3.3.
bsmith@81767d24-ef19-dc11-ae90-00e081727c95
parents:
2674
diff
changeset
|
125 Click "Next" and then "Finish" |
2672
d2c3b17a4ddf
Remove the unicode characters that LibreOffice put into the text.
bsmith@81767d24-ef19-dc11-ae90-00e081727c95
parents:
2671
diff
changeset
|
126 17. Right click "app" and click New -> Image Asset |
2875
d15517b49638
Update the mobile document with updated information for 3.3.
bsmith@81767d24-ef19-dc11-ae90-00e081727c95
parents:
2674
diff
changeset
|
127 "Icon Type" select "Launcher Icons (Legacy Only)" |
d15517b49638
Update the mobile document with updated information for 3.3.
bsmith@81767d24-ef19-dc11-ae90-00e081727c95
parents:
2674
diff
changeset
|
128 "Name" enter "ic_launcher_round" |
d15517b49638
Update the mobile document with updated information for 3.3.
bsmith@81767d24-ef19-dc11-ae90-00e081727c95
parents:
2674
diff
changeset
|
129 "Asset Type" check "Image" |
d15517b49638
Update the mobile document with updated information for 3.3.
bsmith@81767d24-ef19-dc11-ae90-00e081727c95
parents:
2674
diff
changeset
|
130 "Path" click the folder icon and select the largest launcher image you have. |
d15517b49638
Update the mobile document with updated information for 3.3.
bsmith@81767d24-ef19-dc11-ae90-00e081727c95
parents:
2674
diff
changeset
|
131 "Shape" select "Circle" |
d15517b49638
Update the mobile document with updated information for 3.3.
bsmith@81767d24-ef19-dc11-ae90-00e081727c95
parents:
2674
diff
changeset
|
132 Click "Next" and then "Finish" |
2671
0ed61ddb9957
Add a mobile platform text file with instructions on how to create projects.
bsmith@81767d24-ef19-dc11-ae90-00e081727c95
parents:
diff
changeset
|
133 |
0ed61ddb9957
Add a mobile platform text file with instructions on how to create projects.
bsmith@81767d24-ef19-dc11-ae90-00e081727c95
parents:
diff
changeset
|
134 |