App initialization

[nickwalkmsft]

Conceptual content about app initialization in TeamsJS.

ADO: https://domoreexp.visualstudio.com/MSTeams/_workitems/edit/4516137

Preview of main page of interest: TeamsJS App Initialization Process

[microsoft-production-github-app]

Acrolinx Scorecards

We currently enforce a minimum score of 80.

Click the scorecard links for each article to review the Acrolinx feedback on grammar, spelling, punctuation, writing style, and terminology:

Article	Score	Issues	Scorecard	Processed
msteams-platform/TOC.yml	92	25	link	✅
msteams-platform/tabs/how-to/app-caching.md	90	23	link	✅
msteams-platform/tabs/how-to/app-initialization-process.md	87	20	link	✅
msteams-platform/tabs/how-to/create-tab-pages/content-page.md	91	9	link	✅

More info about Acrolinx

Use the Acrolinx extension, or sidebar, in Visual Studio Code to check spelling, grammar, style, tone, clarity, and key terminology when you're creating or updating content. For more information, see Use the Visual Studio Code extension to run Acrolinx locally.

[learn-build-service-prod]

Learn Build status updates of commit 21f3804:

✅ Validation status: passed

File	Status	Preview URL	Details
msteams-platform/assets/images/tabs/app-initialization-immediate-flow.png	✅Succeeded	View
msteams-platform/assets/images/tabs/app-initialization-loading-indicator-flow-cache-transitions.png	✅Succeeded	View
msteams-platform/assets/images/tabs/app-initialization-loading-indicator-flow.png	✅Succeeded	View
msteams-platform/tabs/how-to/app-caching.md	✅Succeeded	View
msteams-platform/tabs/how-to/app-initialization-process.md	✅Succeeded	View
msteams-platform/tabs/how-to/create-tab-pages/content-page.md	✅Succeeded	View
msteams-platform/TOC.yml	✅Succeeded	View

For more details, please refer to the build report.

[learn-build-service-prod]

PoliCheck Scan Report

The following report lists PoliCheck issues in PR files. Before you merge the PR, you must fix all severity-1 and severity-2 issues. The AI Review Details column lists suggestions for either removing or replacing the terms. If you find a false positive result, mention it in a PR comment and include this text: #policheck-false-positive. This feedback helps reduce false positives in future scans.

✅ No issues found

More information about PoliCheck

Information: PoliCheck | Severity Guidance | Term
For any questions: Try searching the learn.microsoft.com contributor guides or post your question in the Learn support channel.

[jekloudaMSFT]

re: transition 2, I don't think an app can move itself out of the Error state by reloading. Hosts provide a reload button that users can click to reload the app, but there is no app-initiated way to do this after a timeout or error event.
Same applies to the Loading App state diagram

[KangxuanYe]

As we discussed before, we MAY want to include app.notifyFailure into the transition to consider failure as a type of error state.